git clone https://github.com/JoelBondoux/AtlasMind.git
cd AtlasMind
npm install
npm run compile

Press F5 in VS Code to launch the Extension Development Host with AtlasMind loaded.

If you plan to use the Copilot provider, install the GitHub Copilot Chat extension and sign in.

npm run package          # produces atlasmind-<version>.vsix
code --install-extension atlasmind-<version>.vsix

Open the Command Palette (Ctrl+Shift+P) → AtlasMind: Manage Model Providers.

Add an API key for at least one provider:

API keys are stored securely in VS Code's SecretStorage — never on disk or in settings files.

For a new project:

@atlas /bootstrap

This creates the SSOT memory folder structure and optionally scaffolds CI/CD and governance files.

For an existing codebase:

@atlas /import

This scans your workspace for package.json, README.md, tsconfig.json, license files, and directory structure, then auto-populates memory with project metadata.

Type @atlas in the VS Code chat panel and ask anything:

@atlas How is this project structured?
@atlas Write unit tests for the auth module
@atlas /project Refactor the API layer to use dependency injection

The orchestrator automatically selects the best agent and model for each request.

Open AtlasMind: Open Settings from the Command Palette to configure:

• Budget Mode — cheap, balanced, expensive, or auto
• Speed Mode — fast, balanced, considered, or auto

These preferences steer model selection across all providers. See Model Routing for details.

After activation, the AtlasMind sidebar appears with:

• Chat Commands — learn all slash commands
• Agents — create custom agents for your workflow
• Skills — explore the 26 built-in tools
• Memory System — understand long-term project memory
• Project Planner — run autonomous multi-step tasks