> ## Documentation Index
> Fetch the complete documentation index at: https://docs.standardagentbuilder.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Create a Standard Agents project through the platform and start building

# Installation Guide

Standard Agents projects are created through the Standard Agents platform. One command signs you in, provisions your project repository, and starts a local dev server — building and running agents locally is free, and upgrading to Pro deploys the same project to the managed global edge.

## Create a Project

Run the CLI from the directory where you want your project:

<CodeGroup>
  ```bash npm theme={null}
  npx @standardagents/cli@latest init
  ```

  ```bash pnpm theme={null}
  pnpm dlx @standardagents/cli@latest init
  ```

  ```bash yarn theme={null}
  yarn dlx @standardagents/cli@latest init
  ```

  ```bash bun theme={null}
  bunx @standardagents/cli@latest init
  ```
</CodeGroup>

This command will:

1. Open Standard Agents in your browser for login and project creation
2. Create and seed a platform-owned repository with the Standard Agents project template
3. Clone that repository back to the directory where you ran the command
4. Write local-only project credentials to `.dev.vars`
5. Configure Git credentials for future pushes to the platform repository
6. Install dependencies with the detected package manager, start the local dev server, and open it in your browser

That's it — there is nothing to configure by hand. The `builder()` Vite plugin in the generated project owns the Worker entry, Cloudflare bindings, Durable Object migrations, and TypeScript type generation.

<Info>
  Building and running agents locally is free on the Hobby plan. When you're ready to ship, upgrade to Pro and every push to your platform repository deploys to the managed global edge.
</Info>

## Install the Coding Skill

Most Standard Agents projects are built with an AI coding agent. The `agentbuilder` skill teaches your coding agent when to reach for `defineModel`, `definePrompt`, `defineTool`, `defineAgent`, `defineHook`, `defineThreadEndpoint`, and `dual_ai` subagents — install it before you start building:

```bash theme={null}
npx @standardagents/cli skill
```

This opens an interactive picker so you can choose the install target:

* **Claude Code**: installs a user subagent into `~/.claude/agents/agentbuilder.md`
* **Codex**: installs a skill folder into `$CODEX_HOME/skills` or `~/.codex/skills`

You can also target an agent directly, overwrite an existing copy, or choose a different install root:

```bash theme={null}
npx @standardagents/cli skill --agent claude
npx @standardagents/cli skill --agent codex --dir ~/.codex/skills
npx @standardagents/cli skill --force
```

See [@standardagents/skill](/user-interfaces/skill) for what the skill covers and how to customize it.

## Adding to an Existing Project

If you already have a Vite project and want to add Standard Agents:

```bash theme={null}
npx @standardagents/cli@latest scaffold
```

The `scaffold` command intelligently modifies your existing project:

* Adds or updates `@standardagents/builder` in `package.json`
* Adds the `builder()` plugin to your `vite.config.ts`
* Lets `builder()` generate the Cloudflare Worker entry, assets config, Durable Object bindings, compatibility flags, and migrations at build time
* Creates the `agents/` directory structure

<Info>
  Use `--force` flag to overwrite existing configuration if needed.
</Info>

## Project Structure

After installation, your project will have this structure:

```
your-project/
├── agents/
│   ├── agents/             # Agent definitions
│   ├── prompts/            # Prompt/system message definitions
│   ├── models/             # AI model configurations
│   ├── tools/              # Custom tools agents can call
│   ├── hooks/              # Lifecycle hooks
│   └── api/                # Thread-specific API endpoints
├── vite.config.ts          # Uses builder()
└── tsconfig.json           # TypeScript configuration
```

The dev server generates types for your agents, prompts, tools, and API routes automatically, and runs a local simulation of the Cloudflare Worker environment.

## Next Steps

<CardGroup cols={2}>
  <Card title="Architecture" icon="sitemap" href="/introduction/architecture">
    Learn how Standard Agents works
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/introduction">
    Explore the complete API
  </Card>
</CardGroup>