Skip to content

Getting Started

Dokugent CLI is currently in early alpha. Expect some commands to shift or evolve. We're documenting stable patterns as we go.

This section walks you through:

  • Installing Dokugent
  • Setting up your first project
  • Creating your first agent
  • Adding signing keys
  • Compiling agent data for preview
  • Certifying signed agents
  • Optional: Defining compliance and I/O contracts

Dokugent separates agent authoring from final output. Your agent’s metadata, behavioral constraints, and trust layers are scaffolded as readable, versioned files. You’re free to bring your own LLMs, plugins, and tools.

For the broader strategy, check the Overview section first.

Key Steps

1. Install Dokugent

Install globally via npm or use npx for local workflows.

2. Initialize Your Project

Start with dokugent init to scaffold the .dokugent/ folder structure.

3. Generate Signing Keys

Create your public/private keypair and metadata. Keys are required to certify an agent.

4. Plan, Define Criteria, and Add Conventions

Set your agent’s behavioral rules, goals, and alignment structure.

5. Preview Before Certify

Compile and validate your agent’s plan, criteria, io, and compliance settings.

6. Certify Your Agent

Sign your agent with a verifiable .cert.json. This marks the agent as trusted and ready for downstream use.

Set Up Compliance and IO Contracts

Define your agent’s expected inputs/outputs and its ethical/safety boundaries. These don’t block execution, but they help with audits, downstream integrations, and social trust.

Compile Output for Deployment

After certification, generate a deployment-ready bundle in .dokugent/ops/compiled.