First run

Use this guide after the installer finishes.

Move into Agentic OS

The installer creates an agentic-os folder inside the folder you chose.

When setup finishes, your terminal may still be one level above it. Move into the new folder first:

cd agentic-os

Start Claude Code

Start Claude Code from inside the Agentic OS workspace:

claude

Claude Code should read the Agentic OS instructions from CLAUDE.md and AGENTS.md.

Start the first setup

Type:

/start-here

You can also type:

start here

On a new workspace, Agentic OS may start this setup automatically.

If /start-here does not appear as a slash command, type start here instead.

The setup asks about your business, voice, audience, and positioning. It uses your answers to create the first brand foundation.

This usually takes about 15 minutes.

Confirm the workspace

After setup, check that these files and folders exist:

Read Workspace structure for details.

Work normally

After the first setup, talk to Agentic OS like a team member.

Examples:

• Write copy for my landing page.
• Repurpose this YouTube video into social posts.
• Research what is trending in AI automation.
• Write a UGC script for this product.
• Generate an infographic of my workflow.

Agentic OS chooses the right skill, reads your brand context, and saves useful context as you work.

Success checklist

Your first run is complete when:

• Claude Code starts from inside agentic-os;
• /start-here or start here begins the guided setup;
• brand_context/ has your first brand foundation;
• AGENTS.md and CLAUDE.md are both present;
• no real API keys or tokens were committed.

Next: Updating Agentic OS