CLI Reference

Complete reference for all kodingo-cli commands.

Installation

npm install -g kodingo-cli

Current version: 1.0.12

Commands

kodingo init

Initialises Kodingo in the current environment. Prompts for API URL and token, writes ~/.kodingo/config.json, and automatically adds .kortex/ to .gitignore.

kodingo init

kodingo capture

Manually capture a memory record.

kodingo capture --type decision --title "Why we use PostgreSQL" --content "Chose PostgreSQL for its JSONB support and reliability."

Options:

  • --type — decision, note, or context (required)
  • --title — short title for the memory
  • --content — full description
  • --symbol — function or file the memory relates to
  • --tags — comma-separated tags

kodingo query-memory

Search your memory records by keyword.

kodingo query-memory "authentication"

Options:

  • --limit — number of results (default: 10)
  • --repo — filter by repo path

kodingo query-symbol

Look up memories for a specific symbol (function, class, or file).

kodingo query-symbol "validateToken"

kodingo explain-symbol

Returns the best canonical explanation for a symbol.

kodingo explain-symbol "processPayment"

kodingo affirm

Mark a memory record as affirmed (confirmed correct).

kodingo affirm <memory-id>

kodingo deny

Mark a memory record as denied (incorrect or outdated).

kodingo deny <memory-id>

kodingo ignore

Mark a memory record as ignored (not relevant).

kodingo ignore <memory-id>

kodingo scan-git

Manually scan the latest git commit and capture memories.

kodingo scan-git

kodingo scan-claude

Scan Claude Code session files from .claude/sessions/ in the current repo. Extracts decisions, rationale, and rejected approaches from AI agent sessions that never made it into a commit.

kodingo scan-claude

Options:

  • --repo — path to the repo to scan (defaults to current directory)

kodingo install-hook

Installs a post-commit git hook in the current repo. After installation, every commit triggers scan-git automatically.

kodingo install-hook

kodingo uninstall-hook

Removes the Kodingo post-commit git hook.

kodingo uninstall-hook

kodingo sync

Syncs any queued offline captures to the cloud. Captures made while offline are stored locally and flushed when connectivity is restored.

kodingo sync

kodingo aging

Lists memory records that have not been updated in 90 or more days. Useful for identifying stale knowledge.

kodingo aging

kodingo update

Updates kodingo-cli to the latest version.

kodingo update

kodingo doctor

Checks your Kodingo setup and reports any configuration issues.

kodingo doctor