Local install

This guide installs Agentic OS locally with the guided installer.

Before you start, check Prerequisites.

Create a blank folder

Create a new folder anywhere you want.

You can name it anything. For example:

my-agentic-os

Open VS Code, choose Open Folder, and select that folder.

Open a terminal inside VS Code.

On Windows, use PowerShell. Do not use Git Bash for the installer.

Run:

npx @scrapes/installer

The installer opens a guided menu.

If GitHub access is already set up, the installer uses it. If it needs a token, it asks for one during setup.

Do not paste real tokens into docs, screenshots, or committed files.

In the installer menu:

The installer creates an agentic-os folder inside your chosen folder.

It also checks for required tools, shows available skills, and connects them to Claude Code.

The five core skills are always installed. Some optional skills may ask for an API key. Most skills still work without keys.

Add API keys to .env only when you need them. Check .env.example for the full list of supported keys.

If you already have projects, folders, files, or notes, keep their current structure.

Install Agentic OS into a dedicated blank folder. Then move your existing work inside projects/.

Add a short note in CLAUDE.local.md that explains where the old work lives and what it contains.

Do not edit base CLAUDE.md for personal project notes. Base files are updated by Agentic OS. Read Custom edits for the safe local layer.

Setup is complete when the installer finishes and the new agentic-os folder exists.

Your terminal may still be one level above that folder.