Skip to main content
Use Claude Code, Codex, or Cursor to set up, build, improve, evaluate, review, and deploy an AgentOS Starter. The repository gives your coding agent the source code, a live MCP endpoint, evals, and runtime logs in one place. It can make a change, exercise it against the running platform, and bring back a verified result. Everything on this page runs inside a cloned AgentOS Starter. If you don’t have one running yet, pick a Starter first.

Skills

Each AgentOS Starter stores its coding-agent workflows in .agents/skills/. The setup prompt invokes the setup-platform skill from .agents/skills/. Claude Code also discovers the skills through the Starter’s committed .claude/skills symlink. Codex and Cursor can link to the same .agents/skills/ directory.

Connect the live platform

Connect the local AgentOS to the supported clients on your machine:
The command registers AgentOS with detected Claude Code, Claude Desktop, Codex, and Cursor clients. Your coding agent can then call run_agent, run_team, and run_workflow while it works on the repository. For a deployed platform:
See Connect Your Clients for authentication modes and client-specific setup.

Keep behavior stable with evals

Use the bundled eval suite to check response quality and tool calls as you change instructions, tools, and models. The evals run on the host machine, so set up the virtual environment once:
Then run:
Cases wrap AgentAsJudgeEval (LLM judge, binary pass/fail) and ReliabilityEval (tool-call assertions). Results log to Postgres, so run history shows up at os.agno.com next to sessions and traces. If a case fails, run /eval-and-improve.

Agent patterns

The bundled agents demonstrate three patterns to copy:

Scheduled tasks

The scheduler is on by default. Two reference workflows are registered out of the box: See Scheduler for the cron API.

Next steps