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 inspect

Print the fully resolved manifest configuration.

agentc inspect parses your agent.acl manifest and resolves it into a fully expanded context. No pipeline stages run and no files are generated. It is the fastest way to verify that your manifest is structurally valid and that all values resolve as expected.

agentc inspect [CONTEXT] [OPTIONS]

Arguments

ArgumentDefaultDescription
CONTEXT.Path to the directory containing agent.acl.

Options

FlagDefaultDescription
--format <FORMAT>autoOutput format. auto selects TTY or plain based on the terminal.
--rawfalsePrint the parsed manifest as a raw debug struct instead of the resolved context. Useful for checking how HCL was deserialized before resolution runs.

What it shows

By default, the command prints the resolved context: the manifest after all build-time processing has been applied.

  • locals values are substituted wherever they are referenced in string fields.
  • runtime(ENV_VAR, default) fields display their compile-time default value. The environment variable itself is not read during inspection.
  • secret(runtime(...)) values are not read or displayed.
  • Provider and tool configurations are shown in their resolved form.

With --raw, the command prints the raw deserialized manifest struct before resolution. This is useful for checking that runtime() and secret() calls were parsed correctly.

When to use it

Use agentc inspect to verify your manifest before starting a build. It catches structural errors and lets you confirm that interpolation, defaults, and field references are wired up correctly, without triggering any tool transforms or code generation.

It is also helpful for understanding what defaults a deployed binary will fall back to for each runtime() field.

Example

agentc inspect
agentc inspect ./agents/support
← Previousagentc generateNext →Manifest

© 2026 pogue.dev. All rights reserved.

Creative CommonsCC BY 4.0
On this pageArgumentsOptionsWhat it showsWhen to use itExample

Search docs

Search the agentc documentation