Commands¶

Run kenn-forge --help for the complete command tree. Most commands accept --config, --server, and --timeout where they apply.

Start and inspect the daemon¶

kenn-forge
kenn-forge serve
kenn-forge serve --config /path/to/config.toml
kenn-forge start --background
kenn-forge status
kenn-forge status --json

kenn-forge and kenn-forge serve run in the foreground. Background start returns after the daemon publishes its ready identity. It requires a loopback listener and safely reuses a compatible running process.

Direct foreground starts still reject a second process using the same data directory.

Check build information¶

kenn-forge version
kenn-forge version --json

The JSON object contains name, version, commit, and buildDate. buildDate is a UTC RFC3339 timestamp or unknown for an uninjected build. This command does not read config or connect to a daemon.

Query and sync data¶

The CLI includes commands for activity, issues, pulls, repos, repo-summaries, stacks, workspaces, rate-limits, and sync. Use the command help before scripting an output shape:

kenn-forge pulls --help
kenn-forge sync --help

Relay an API request¶

kenn-forge api list
kenn-forge api GET /api/v1/version
kenn-forge api POST /api/v1/sync
kenn-forge api -i GET /api/v1/pulls

kenn-forge api discovers the selected daemon and supplies its local credential. Use --data @- to read a request body from stdin. Exit status 0 means 2xx, 1 means another HTTP status, and 2 means no request was made.

Manage historical archives¶

kenn-forge archive start --all
kenn-forge archive start --repo 'github|github.com/owner/repo'
kenn-forge archive status --json
kenn-forge archive pause --all
kenn-forge archive report --days 7
kenn-forge archive report --start 2026-07-01 --end 2026-07-07 --verbose

Use repeated --repo flags for multiple repositories. Reports default to Markdown. Add --format json or --output PATH when needed.

See Historical activity archive for coverage and status rules.

Read configuration¶

kenn-forge config read port
kenn-forge config read --config /path/to/config.toml port

Use Settings or edit TOML for normal configuration changes.

Manage Docs folders¶

kenn-forge docs list-folders
kenn-forge docs add-folder --name Docs ~/docs
kenn-forge docs add-folder --id project --daemon kata-main ~/project-docs
kenn-forge docs remove-folder project

These commands manage [[doc_folders]] in the selected config file.

Install agent activity hooks¶

kenn-forge agent-hook install
kenn-forge agent-hook install --agent codex
kenn-forge agent-hook uninstall
kenn-forge agent-hook uninstall --agent codex

Without --agent, install or remove every supported integration. Installed hooks send lifecycle activity to the running daemon. Codex asks you to review the installed commands through /hooks once.

Manage GitHub App credentials¶

kenn-forge-github-app create
kenn-forge-github-app list
kenn-forge-github-app install
kenn-forge-github-app uninstall
kenn-forge-github-app delete
kenn-forge-github-app open

Use this companion CLI when sync reads should use GitHub App installation tokens. Comments, reviews, state changes, and merges still use the user PAT chain.