CLI Reference

Complete command reference for @dcyfr/ai-cli.

Install

npm install -g @dcyfr/ai-cli

dcyfr agent run

@dcyfr/ai-clisince 0.3.0

Run a workspace agent on a given task. Streams output to stdout and writes a structured run record to ~/.dcyfr/runs/.

Usage

dcyfr agent run <agentId> --intent <intent> [--input <json>] [--timeout <ms>]

Flags

--intent-irequired

Task intent string (what you want the agent to accomplish)

--input

JSON object of inputs to pass to the agent

--timeout-t

Maximum execution time in milliseconds (default: 60000)

--no-stream

Disable streaming output; print final result only

Examples

dcyfr agent run documentation-expert --intent 'Generate API reference for ./src/auth'

dcyfr agent run security-engineer --intent 'Audit for OWASP Top 10' --input '{"path":"./src"}'

dcyfr agent run test-engineer --intent 'Add unit tests for PaymentService' --timeout 120000

dcyfr agent list

@dcyfr/ai-clisince 0.1.0

List all available workspace agents with their categories, TLP clearance, and reputation scores.

Usage

dcyfr agent list [--category <category>] [--json]

Flags

--category-c

Filter by agent category (frontend/backend/infrastructure/security/governance)

--json

Output as JSON array

Examples

dcyfr agent list

dcyfr agent list --category security

dcyfr agent list --json | jq '.[].agentId'

dcyfr delegate

@dcyfr/ai-clisince 0.3.0

Create and execute a typed delegation contract. Validates inputs against the agent's manifest schema before dispatch.

Usage

dcyfr delegate --to <agentId> --intent <intent> [--fallback <behavior>]

Flags

--torequired

Target agent ID

--intent-irequired

Intent string describing the task

--fallback

Fallback behavior on failure: abort | return-partial | retry (default: abort)

--dry-run

Validate the delegation contract without executing

Examples

dcyfr delegate --to documentation-expert --intent 'Document the ./lib/auth module'

dcyfr delegate --to worktree-coordinator --intent 'Set up isolation for 3 parallel changes' --fallback return-partial

dcyfr delegate --to security-engineer --intent 'Scan for secrets in git history' --dry-run

dcyfr runs list

@dcyfr/ai-clisince 0.2.0

Show recent agent run records from ~/.dcyfr/runs/. Displays status, agent, duration, and token usage.

Usage

dcyfr runs list [--all] [--agent <agentId>] [--prune <days>]

Flags

--all

Show all runs (default: last 20)

--agent

Filter runs by agent ID

--prune

Delete runs older than N days and exit

Examples

dcyfr runs list

dcyfr runs list --agent documentation-expert

dcyfr runs list --all --agent security-engineer

dcyfr runs list --prune 7

dcyfr workspace health

@dcyfr/ai-clisince 0.4.0

Run a workspace health check. Verifies Intelligence Gateway connectivity, agent availability, npm dependency freshness, and TLP policy file presence.

Usage

dcyfr workspace health [--json] [--fix]

Flags

--json

Output results as JSON

--fix

Attempt to auto-fix warning-level issues (e.g. reinstall missing packages)

Examples

dcyfr workspace health

dcyfr workspace health --json

dcyfr workspace health --fix

dcyfr openspec new

@dcyfr/ai-clisince 0.4.0

Create a new OpenSpec change directory with all required artifact stubs (proposal.md, design.md, tasks.md, specs/).

Usage

dcyfr openspec new <change-name> [--tlp <GREEN|AMBER|RED>]

Flags

--tlp

TLP classification for all artifacts (default: AMBER)

Examples

dcyfr openspec new my-new-feature

dcyfr openspec new public-api-redesign --tlp GREEN

dcyfr openspec new internal-auth-refactor --tlp AMBER