Documentation

Install

macOS / Linux:

curl -fsSL https://cli.sakura-ai.dev/install | bash

Windows (PowerShell):

irm https://cli.sakura-ai.dev/install.ps1 | iex

Requires Node.js 20+.

Sign up

Create an account at sakura-ai.dev/signup.

Log in

sakura login --github
# or
sakura login --email you@example.com --password yourpassword

Start chatting

sakura-cli

Or equivalently: sakura chat or just sakura with no arguments.

Sakura has 11 tools that the AI calls automatically during conversation using structured function calling. You don't need to invoke them manually — just ask Sakura to do something and she'll pick the right tool.

Trust Levels

• trusted — runs automatically, no approval needed
• trust working dir — auto-runs within your project directory, asks permission for paths outside it
• trust read-only — auto-runs read operations, asks permission for mutations (e.g. AWS write commands)
• approval required — always asks before executing

Tool Output

When Sakura uses a tool, you'll see what's happening:

Reading file: /Users/you/project/src/config.ts, from line 1 to end (using tool: read)
 ✓ Successfully read 2141 bytes from /Users/you/project/src/config.ts

Sakura automatically routes each request to the cheapest appropriate model to minimize credit usage:

Use these inside sakura chat:

Sakura uses a trust-based safety model:

• Read-only operations run immediately (file reads, searches, AWS describe/list)
• Mutating operations require your approval:

- [n] Deny

- [t] Trust for session

AWS commands are classified automatically — read-only commands like describe-instances run freely, while create-bucket or terminate-instances require confirmation.

Code changes are generated as diffs, shown to you, and only applied after approval. Use sakura undo to reverse the last patch.

Error Recovery

When a command fails, Sakura will automatically try to diagnose and fix the issue — up to 2 attempts with escalating strategies. If it can't recover, it'll explain what went wrong and suggest what you can do manually.

Context Window

Use /context to see how much of the context window you've used. Sakura auto-compacts conversation history when it gets too large.

Sessions

Conversations are saved automatically. Use /chat resume to pick up where you left off, or /new to start fresh.

Context Switching

Sakura uses recent conversation history for intent classification, so you can switch topics naturally without getting stuck in a mode. If you mention "EC2" in passing, she won't suddenly try to run AWS commands.