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

# Kaneo CLI

> Manage tasks and projects from your terminal with the official Kaneo command-line client.

The official Kaneo CLI is a single `kaneo` binary for macOS, Linux and Windows. It works with Kaneo Cloud and self-hosted instances, shows styled output in a terminal, and prints plain JSON for scripts and agents.

## Quick start

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
curl -fsSL https://kaneo.app/cli/install.sh | sh
kaneo login
kaneo
```

On Windows, install it in PowerShell with `irm https://kaneo.app/cli/install.ps1 | iex`. Homebrew (`brew install usekaneo/tap/kaneo`) and npm (`npm install -g @kaneo/cli`, Node.js 20 or newer) work too. [Install](https://kaneo.app/docs/cli/install.md) covers versions, mirrors and supported systems, and [Sign in](https://kaneo.app/docs/cli/sign-in.md) covers self-hosted servers and API keys.

## Everyday commands

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
kaneo workspace list
kaneo workspace use            # pick the default workspace
kaneo project list
kaneo task list -p KAN         # tasks grouped by column
kaneo task list -p KAN --mine --open
kaneo task mine                # your open tasks, soonest due first
kaneo task view KAN-12
kaneo task create "Fix login redirect" -p KAN --priority high --due tomorrow
kaneo task status KAN-12 done
kaneo task assign KAN-12 me
kaneo comment add KAN-12 "Shipped in v2.35"
kaneo time start KAN-12
kaneo time stop
kaneo task open KAN-12
kaneo search "login redirect"
```

Tasks are addressed by their ticket ID, such as `KAN-12`, or by their ID. If a ticket ID exists in more than one of your workspaces, pass `-w` to choose one.

When a workspace, project or column is missing and you are in a terminal, the CLI shows a searchable picker. In scripts it stops with an error that names the flag to pass.

Every command has `--help`, and the [command reference](https://kaneo.app/docs/cli/reference.md) lists every argument and flag. Print a shell completion script with `kaneo --completions zsh` (or `bash`, `fish`, `sh`).

## Update

Run the install command again. It replaces `kaneo` with the latest release and keeps your logins and settings. See [Install](https://kaneo.app/docs/cli/install.md#update) for pinned versions and mirrors.

## Next steps

> **[Install](https://kaneo.app/docs/cli/install.md)**
>
> Pin a version, use a mirror, update and uninstall.

> **[Sign in](https://kaneo.app/docs/cli/sign-in.md)**
>
> Self-hosted servers, API keys for CI, and several logins.

> **[Configuration](https://kaneo.app/docs/cli/configuration.md)**
>
> Environment variables, repository defaults and inline images.

> **[Scripts and agents](https://kaneo.app/docs/cli/scripting.md)**
>
> JSON output, jq filters, raw API calls and the agent skill.

> **[Command reference](https://kaneo.app/docs/cli/reference.md)**
>
> Every command with its arguments and flags.

> **[MCP server](https://kaneo.app/docs/core/integrations/mcp.md)**
>
> Connect AI assistants such as Claude and Cursor without a shell.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.