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

# AI assistants

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

The CLI is built to be driven by AI coding assistants. The `neetocal setup` commands register NeetoCal instructions with your assistant so it knows how to manage your calendar, and the [`--toon`](/cli/output-formats) format keeps responses compact when the assistant reads command output back.

## Set up your assistant

Run the subcommand for the tool you use:

| Command                   | What it does                                                                        |
| ------------------------- | ----------------------------------------------------------------------------------- |
| `neetocal setup claude`   | Registers the NeetoCal plugin with Claude Code (plugin manifest, hooks, and skill). |
| `neetocal setup cursor`   | Writes NeetoCal rules for the Cursor IDE.                                           |
| `neetocal setup windsurf` | Writes NeetoCal rules for the Windsurf IDE.                                         |
| `neetocal setup copilot`  | Adds NeetoCal instructions for GitHub Copilot.                                      |
| `neetocal setup gemini`   | Adds NeetoCal instructions for the Gemini CLI.                                      |
| `neetocal setup codex`    | Adds NeetoCal instructions for OpenAI Codex.                                        |

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

After setup, your assistant can discover the full, always-accurate command tree at any time by running:

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

This prints every command and flag as JSON, so the assistant stays in sync with the installed CLI version.

## 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 [`neetocal login`](/cli/authentication); the assistant reuses the stored credentials.
* When several workspaces are logged in, the assistant must pass `--subdomain <name>` on each command.
* Run [`neetocal doctor`](/cli/troubleshooting) first to confirm the assistant is authenticated and connected.