Kindship CLI

Command-line interface for orchestrating AI coding agents. Make Claude Code, Gemini CLI, Codex, and OpenCode fully autonomous.

The Kindship CLI is an orchestrator for AI coding agents. It enables autonomous workflows by connecting your favorite coding agent to Kindship's planning and execution system.

Supported Agents

Claude Code — Anthropic's CLI for Claude
Gemini CLI — Google's Gemini coding assistant
Codex — OpenAI's coding agent
OpenCode — Open-source coding agent

Installation

macOS / Linux

curl -fsSL https://kindship.ai/install.sh | sh

Homebrew

brew install kindship-ai/tap/kindship

Go

go install github.com/kindship-ai/kindship-cli@latest

Quick Start

1. Authenticate

kindship login

This opens your browser for authentication. Once complete, your credentials are stored securely in ~/.kindship/config.json.

2. Set up a repository

Navigate to your project and run:

kindship setup

This links the repository to a Kindship agent and installs Claude Code hooks.

3. Submit a plan

Create a plan and submit it:

kindship plan submit my-plan.md

4. Execute tasks

Your agent can now fetch and execute tasks autonomously:

kindship run next      # Get next available task
kindship run complete  # Mark current task complete

How It Works

You create a plan — Define objectives, projects, and tasks in Kindship
Agent fetches work — The CLI provides the next task to your coding agent
Agent executes — Your agent works autonomously on the task
Agent reports back — The CLI reports completion and fetches the next task

Commands

Command	Description
`kindship login`	Authenticate with Kindship
`kindship logout`	Log out and revoke token
`kindship whoami`	Show current user and agent
`kindship setup`	Initialize repository with agent binding
`kindship status`	Show repository and agent status
`kindship version`	Show CLI version
`kindship update`	Update CLI to latest version
`kindship plan submit`	Submit a plan file
`kindship plan export`	Export an entity and its descendants as JSON
`kindship plan import`	Import entities from an export file
`kindship plan next`	Get the next executable task
`kindship entity list`	List planning entities
`kindship entity create`	Create a planning entity
`kindship entity update`	Update a planning entity
`kindship entity get`	Get details of a planning entity
`kindship entity delete`	Delete a planning entity (soft-delete)
`kindship entity restore`	Restore a deleted entity
`kindship entity move`	Move an entity to a new parent
`kindship entity activate`	Activate a DRAFT entity
`kindship entity deps`	Manage entity dependencies
`kindship run`	Execute a planning entity
`kindship agent loop`	Run autonomous execution loop
`kindship site create`	Create a new hosted site
`kindship site list`	List your sites
`kindship site status`	Get site info and build status
`kindship site push`	Publish a local site workspace
`kindship site logs`	View build logs
`kindship site delete`	Delete a site
`kindship site domain`	Manage custom domains (set, status, remove, check, register)
`kindship attach read`	Read an attachment's content
`kindship attach write`	Create or update a text attachment
`kindship attach list`	List all attachments for the current entity
`kindship dns credentials`	Manage DNS provider credentials

Plan Export & Import

Export any planning entity and its full descendant tree as a flat JSON array:

kindship plan export <entity-id>                    # Text tree view
kindship plan export <entity-id> --output plan.json # Save to file
kindship plan export <entity-id> --include-deleted  # Include deleted entities

Import entities from an export file (round-trip safe):

kindship plan import plan.json              # From file
kindship plan export <id> | kindship plan import  # Pipe from export

Entities with existing UUIDs are updated; new UUIDs are created. See Plan Format for details.

Entity Tags

Use --tags when creating or updating entities via the CLI:

kindship entity create --type TASK --parent <id> --title "One-time import" --mode BASH --code "..." --tags ephemeral
kindship entity update <id> --tags ephemeral,priority

Tags are also supported in plan submit JSON:

{
  "title": "My Plan",
  "tags": ["ephemeral"],
  "tasks": [
    { "title": "Step 1", "tags": ["ephemeral"], "execution_mode": "BASH", "code": "..." }
  ]
}

The ephemeral tag marks entities for automatic soft-deletion after successful completion — useful for one-time work that would clutter the planning tree.

Learn More

Authentication Guide — Detailed auth flow and token management
Plan Format — How to structure plans for submission and export/import
Claude Code Integration — Setting up hooks and skills