Now on npm npm install -g aiscope

Local scopes for AI coding agents

Auto-loading local scopes for AI coding agents.

Stop exporting global API keys. Stop typing wrapper commands. Enter a project folder, run codex or claude, and the right environment is already active.

Local-first vault zsh and bash macOS and Linux

daily workflow

$ cd ~/projects/demo-app
aiscope: loaded project/demo-app
$ codex

$ cd ..
aiscope: unloaded project/demo-app

Works with the tools builders already use

Codex Claude Code Next.js Vite Node Python Wrangler Vercel

No wrapper commands

Run Codex, Claude Code, npm, Python, Wrangler, Vercel, or any CLI exactly as you normally would.

No global secrets

Keep project secrets in a local vault instead of exporting every API key in your shell config.

Built for AI workflows

Use project and skill scopes today. Agent scopes, workflow scopes, and encrypted vaults can come later.

Safe by default

Env files are parsed as data, status output is masked, and old scope variables are unloaded before new ones load.

The core promise

cd into a project. Run codex. That's it.

Use normal commands. aiscope handles the folder-specific environment in the shell.

mkdir demo-app
cd demo-app
aiscope init project demo-app
aiscope edit
aiscope link
codex

Get started

Install once. Use everywhere.

Install from npm, enable the hook, then create a scoped project.

npm install -g aiscope
eval "$(aiscope hook zsh)"

mkdir demo-app
cd demo-app
aiscope use demo-app
aiscope set OPENAI_API_KEY sk-...