> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.neetokb.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AI assistants

> Set up NeetoKB for Claude, Cursor, Copilot, and other AI coding assistants.

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`](/cli/output-formats) 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`   | Registers the NeetoKB plugin with Claude Code (plugin manifest, hooks, and skill). |
| `neetokb setup cursor`   | Writes NeetoKB rules for the Cursor IDE.                                           |
| `neetokb setup windsurf` | Writes NeetoKB rules for the Windsurf IDE.                                         |
| `neetokb setup copilot`  | Adds NeetoKB instructions for GitHub Copilot.                                      |
| `neetokb setup gemini`   | Adds NeetoKB instructions for the Gemini CLI.                                      |
| `neetokb setup codex`    | Adds NeetoKB instructions for OpenAI Codex.                                        |

```bash theme={"system"}
neetokb setup claude
```

After setup, your assistant can check the commands and flags available in your installed CLI version:

```bash theme={"system"}
neetokb commands
```

The command prints the complete catalog as JSON.

## CLI or MCP?

Both surfaces let an assistant work with NeetoKB. The CLI runs on your machine and reuses your browser sign-in, so it suits coding assistants that already have a terminal. The [MCP server](/mcp/introduction) is hosted by NeetoKB and suits assistants without shell access; it connects with an OAuth grant scoped to you, or an API key scoped to the whole workspace.

## Tips for agent workflows

<Tip>
  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](/cli/output-formats).
</Tip>

* Authenticate once with [`neetokb login`](/cli/authentication); the assistant reuses the stored credentials.
* When several workspaces are signed in, the assistant must pass `--subdomain <name>` on each command.
* Run [`neetokb doctor`](/cli/troubleshooting) first to confirm the assistant is authenticated and connected.
