AI assistants - NeetoKB Docs

Use the CLI with an AI coding assistant to manage NeetoKB in plain language. The neetokb setup commands add NeetoKB instructions for your assistant, while --toon keeps command output compact for it to read.

Set up your assistant

Run the subcommand for the tool you use:

Command	What it does
`neetokb setup claude`	Extracts the NeetoKB plugin (manifest, hooks, and skill) to `~/.config/neetokb/claude-plugin` and prints the `/plugin` slash commands to run inside Claude Code to finish the install. Re-running deletes and re-extracts that directory. Requires Claude Code (`~/.claude` must exist).
`neetokb setup cursor`	Writes the rule file `.cursor/rules/neetokb.mdc`. Re-running overwrites it.
`neetokb setup windsurf`	Writes the rule file `.windsurf/rules/neetokb.md`. Re-running overwrites it.
`neetokb setup copilot`	Adds a NeetoKB section to `.github/copilot-instructions.md`. Existing content is kept; re-running replaces the section.
`neetokb setup gemini`	Adds a NeetoKB section to `GEMINI.md`. Existing content is kept; re-running replaces the section.
`neetokb setup codex`	Adds a NeetoKB section to `AGENTS.md`. Existing content is kept; re-running replaces the section.

neetokb setup claude

Every subcommand except setup claude writes into the current directory, so run it from the root of the project the assistant works in. Run the setup command again after each CLI upgrade so the assistant sees the latest commands. After setup, your assistant can check the commands and flags available in your installed CLI version:

neetokb commands

The command prints the complete catalog as JSON. The catalog leaves out help, completion, and commands itself. Not sure which to use? See CLI vs MCP.

Tips for agent workflows

Prefer --toon when the assistant needs to read a list or record, and --quiet when it needs to pipe an identifier into the next command. See Output formats.

Authenticate once with neetokb login; the assistant reuses the stored credentials.
When several workspaces are signed in, the assistant must pass --subdomain <name> on each command.
Run neetokb doctor first to confirm the assistant is authenticated and connected.