Everything defaults to global scope. Your first agentsinc init sets up your personal default stack — skills, agents, and sources that apply across all projects. Most of the time, that's all you need.
It's tempting to install per-project, but that becomes a maintenance headache. You end up with the same React + Hono + Drizzle stack duplicated across every project, and updating one doesn't update the rest.
Global scope means one installation to maintain. Project scope is only for when a specific project deviates from your defaults.
Run agentsinc init from any directory. Select your primary technologies, agents, and sources. Everything installs at global scope by default.
Your global config lives at ~/.claude-src/config.ts. Agents are compiled to ~/.claude/agents/.
Use project scope when a project needs something different from your global defaults. For example, your global stack uses React but one project uses Vue — that project gets its own project-scoped config.
cd ~/projects/vue-app
agentsinc initToggle specific skills and agents to project scope using the scope hotkey in the wizard. Only override what differs — everything else falls through to global.
Project config lives at .claude-src/config.ts in the project directory. Project-scoped agents are compiled to .claude/agents/ in the project.
Global — Your default stack. The technologies you reach for on most projects, plus meta agents like codex-keeper and skill-summoner that aren't project-specific.
Project — Overrides. A different framework, a project-specific database, agents that need different skill mappings than your global defaults.
agentsinc edit from a project directory shows both global and project skills. Global items appear as locked — edit them from any directory without a project-scoped installation, or from ~/.