# CLI reference

Canonical: https://auggy.dev/docs/cli-reference
Status: Published
Package: auggy 0.5.0

Common **Auggy** CLI commands for creating, extending, and operating agents.

## Commands

| Command | Use |
| --- | --- |
| `auggy create <name>` | Create a standalone agent project. |
| `auggy run` | Run the local agent server. |
| `auggy augment list` | List available built-in and custom augments. |
| `auggy augment add <name>` | Add an augment config, dependencies, and bundled skill when available. |
| `auggy augment create <name>` | Create a custom augment scaffold. |
| `auggy skill create <name>` | Create a skill folder. |
| `auggy skill add <name>` | Refresh a bundled starter or augment skill folder, including auggy and layeredMemory. |
| `auggy skill list` | List skills installed in the current agent. |
| `auggy deploy` | Deploy the current agent to **Railway**. |
| `auggy logs` | Stream logs for the saved **Railway** target. |

A machine-readable version of the CLI and factory API surface, with signatures and per-symbol release status, is served at /api-reference.json.

## Common flows

**Create, extend, inspect, deploy**

```bash
auggy create my-agent
cd my-agent
auggy augment add knowledge layeredMemory
auggy augment create support
auggy doctor
auggy deploy
```

## Advanced preview commands

> **Warning: Optional app integration**
>
> These commands inspect and generate artifacts for preview augment routes. A normal tool-focused agent does not need them.

| Command | Use |
| --- | --- |
| `auggy routes [name]` | Inspect optional deterministic augment routes. |
| `auggy routes [name] --json` | Emit route manifest JSON. |
| `auggy routes [name] --openapi` | Emit an OpenAPI 3.1 document for the agent's routes. |
| `auggy routes [name] --client ts` | Generate a TypeScript route client. |

## Related

- [Run an agent](https://auggy.dev/docs/quickstart/markdown)
- [Build an augment](https://auggy.dev/docs/build-augment/markdown)
- [Deploy and verify](https://auggy.dev/docs/deploy/markdown)