CLI

The opencanon binary talks to the daemon. If no daemon is running, it can start one for a single request.

Context

context

01opencanon context --files src/services/company.service.ts
02opencanon context --list-exceptions

Loads docs, decisions, validators, and optional Git history for files or topics.

Rules

rules

01opencanon rules --validator service-no-db-client
02opencanon rules --decision service-db-boundary
03opencanon rules --tree --validator service-no-db-client

Lists validator summaries, scopes, decisions, and fixture coverage. --tree shows the file scope.

Graph Search

graph-search

01opencanon search loadCompany --kind symbol --symbol-kind function --scope "src/services/**"
02opencanon symbols loadCompany --kind function --scope "src/services/**"
03opencanon graph callers loadCompany
04opencanon graph callees loadCompany
05opencanon refactor rename-symbol loadCompany fetchCompany --file src/services/company.service.ts --format json

Searches the indexed TS/JS graph, filters symbols by kind and file scope, and inspects caller/callee edges before a change or refactor.

Validate

validate

01opencanon validate --changed
02opencanon validate --project --profile
03opencanon validate --check-fixtures
04opencanon validate --changed --strict-warnings

Commit Gates

gate

01opencanon gate pending --format json
02opencanon gate approve <gate-id> \
03  --summary "User explicitly approved the blocked change." \
04  --via agent

Validators can emit commit gates for intent-sensitive changes. Pending gates are written during changed-file validation. Agents should inspect the staged diff and gate evidence, ask the user for explicit Approve or Reject, and only then record the scoped approval before retrying the commit.

Feedback

feedback

01opencanon feedback --changed
02opencanon feedback --changed --strict-warnings

Writes concise findings for an agent after edits.

Daemon

daemon

01opencanon daemon start
02opencanon daemon status
03opencanon daemon list
04opencanon daemon open
05opencanon daemon stop
06opencanon daemon check

Bundles

bundle

01opencanon bundle list
02opencanon bundle inspect ./opencanon.bundle.ts
03opencanon bundle plan ./opencanon.bundle.ts --option sourceRoot=src
04opencanon bundle install ./opencanon.bundle.ts --option sourceRoot=src

Bundles list local examples, inspect metadata, plan installs, and install docs, decisions, validators, impact surfaces, external tool declarations, and owned files.

Runtime Updates

update

01opencanon update check --manifest ./opencanon-runtime-manifest.json
02opencanon update apply --manifest ./opencanon-runtime-manifest.json --dry-run

Updates read a manifest, select the current engine target, and verify checksums before writing runtime assets.

Baselines

baseline

01opencanon baseline check
02opencanon baseline update

Baselines record known findings so validators can distinguish existing debt from new drift.

Diagnostics

diagnostics

01opencanon doctor
02opencanon benchmark --sizes 1000,10000,50000

Local State

01opencanon db status
02opencanon db reset --confirm