Command Line

kikuyo-cli

Manage organizations, projects, and feedback from your terminal. Scriptable, pipe-friendly, and works anywhere Node runs.

Terminal-native

Manage everything from your shell with simple, scriptable commands

One install

npm install -g kikuyo-cli and you're ready to go

JSON output

Use --json for raw API responses, perfect for piping

Install

npm (global)

Installs two identical binaries: kikuyo and kikuyo-cli

npm install -g kikuyo-cli

Authentication

Create an API key from your Account settings, then either pass it per command or set it as an environment variable.

# per command
kikuyo orgs list --api-key kky_your_api_key
# or set once in your shell
export KIKUYO_API_KEY=kky_your_api_key

Usage

By default the CLI talks to https://kikuyo.app/api/v1.

Organizations

kikuyo orgs list
kikuyo orgs get digitalvibes

Projects

kikuyo projects list digitalvibes
kikuyo projects get digitalvibes kikuyo

Feedback

kikuyo feedback list digitalvibes kikuyo --status pending
kikuyo feedback get aeb1d3f6-772f-4838-9e07-770a0eac9c78
kikuyo feedback create digitalvibes kikuyo --title "Add changelog"
kikuyo feedback update-status 96a4d361-... --status planned

Use --json to get the raw API response body.

Command Reference

Command Description
orgs list List all organizations
orgs get <org> Get organization details
projects list <org> List projects in an org
projects get <org> <project> Get project details
feedback list <org> <project> List feedback (optional --status)
feedback get <id> Get a single feedback item
feedback create <org> <project> Create feedback (--title, --body)
feedback update-status <id> Update status (--status)
<org> / <project> accept a UUID or slug
Statuses: pending, planned, in_progress, completed, rejected

Want to use this inside an AI assistant?

kikuyo-cli also works as an agent skill for Claude Code, Claude Desktop, and npx skills. See the Agent Skills setup guide for installation instructions.