agentc
GitHubagentc-sh/agentc
agentc
GitHubagentc-sh/agentc
›Introduction
Get started›Concepts in 5 minutes›Build your first agent›Add your first tool›Serve and connect
Concepts›Architecture overview›The manifest›The compilation pipeline›Archetypes›The graph›Tools and capabilities›Runtime libraries›Skills›Agents and prompts›Serving and protocols›Observability
Guides›Author a manifest›Write a tool›Give your agent a filesystem›Control network egress›Connect external tools via MCP›Connect agents via A2A›Use the bash tool›Control tool access with capabilities›Write templated prompts›Manage prompts with Langfuse›Pass context from the client›Configure a model provider›Connect a CopilotKit frontend›Deploy a standalone binary›Deploy with Docker and PostgreSQL›Instrument with OpenTelemetry›Extend code generation with blocks
Reference
›agentc init›agentc tool init›agentc build›agentc run›agentc generate›agentc inspect
Manifest
Runtime
›Observability

agentc init

Scaffold a new agentc project.

agentc init scaffolds a new agent project with a minimal, ready-to-build manifest and supporting files.

agentc init <NAME> [OPTIONS]

Arguments

ArgumentDescription
NAMEName of the agent project. Used as the agent block label in the manifest and as the default directory name.

Options

FlagShortDefaultDescription
--directory <DIR>-d./<NAME>Directory to create the project in.
--forcefalseOverwrite if agent.acl already exists in the target directory.
--format <FORMAT>autoOutput format. auto selects TTY or plain based on the terminal.

Examples

Scaffold a new project in ./my-agent/:

agentc init my-agent

Scaffold into the current directory:

agentc init my-agent --directory .

Output

On success, the command prints:

 ✓ Created my-agent

The generated manifest is a complete, valid agent.acl that builds immediately with agentc build. It uses the standalone archetype, Anthropic as the model provider, and an AG-UI HTTP server. All configurable values use runtime() so they are read from environment variables at startup rather than baked in at compile time.

← PreviousExtend code generation with blocksNext →agentc tool init

© 2026 pogue.dev. All rights reserved.

Creative CommonsCC BY 4.0
On this pageArgumentsOptionsExamplesOutput

Search docs

Search the agentc documentation