overview

A command reference for Codev, a set of command-line tools for AI-assisted software development, project management, multiple agents, and outside AI consultations.

In plain words
What is it for?
It helps initialize or adopt projects, run environment checks, update templates, start agent workspaces, and consult Gemini, Codex, or Claude about a specification.
Why use it?
It explains which command to use for setting up a project, checking dependencies, coordinating agents, or asking another AI model for advice.

Command

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add commands/cluesmith/codev/overview
Clone the repo
git clone --depth 1 https://github.com/cluesmith/codev
Per session 0 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 671 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00000 $0.00671
Opus 5 $0.00000 $0.00336
Sonnet 5 $0.00000 $0.00134
Haiku 4.5 $0.00000 $0.00067

Measured 2d ago against content hash 6714ee47726e, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

overview scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

codev-skeleton/resources/commands/overview.md · 97 lines

How it starts

The opening of the file, as written. The whole thing — 97 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Codev CLI Command Reference

Codev provides three CLI tools for AI-assisted software development:

Tool Description
codev Project setup, maintenance, and framework commands
afx Agent Farm - multi-agent orchestration for development
consult AI consultation with external models (Gemini, Codex, Claude)

Quick Start

# Create a new project
codev init my-project

# Or add codev to an existing project
codev adopt

# Check your environment
codev doctor

# Start the workspace
afx workspace start

# Consult an AI model about a spec
consult -m gemini --protocol spir --type spec

Installation

npm install -g @cluesmith/codev

This installs all three commands globally: codev, afx, and consult.

Command Summaries

codev - Project Management

Command Description
codev init [name] Create a new codev project
codev adopt Add codev to an existing project
codev doctor Check system dependencies
codev update Update codev templates and protocols
codev import <source> AI-assisted protocol import from other projects

See codev.md for full documentation.

afx - Agent Farm

Command Description
afx workspace start Start the workspace
afx workspace stop Stop all agent farm processes
afx spawn Spawn a new builder
afx status Show status of all agents
afx cleanup Clean up a builder worktree
afx send Send instructions to a builder
afx inbox List/show/dismiss held (undelivered) messages
afx open Open file annotation viewer
afx shell Spawn a utility shell
afx tower Cross-project dashboard

See agent-farm.md for full documentation.

consult - AI Consultation

Command Description
consult -m <model> --prompt "text" General consultation
consult -m <model> --protocol spir --type spec Protocol-based review
consult stats View consultation statistics

Read the full file on GitHub · 97 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 97 lines · 0 tokens per session scan A 6714ee47726e

Subscribe to this mod's changes

overview is a command published in the GitHub repository cluesmith/codev (286 stars, last pushed 5d ago), licensed Apache-2.0. It costs nothing until one of its globs matches a file; then it loads 671 tokens. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.