koban

Drop-in agent skill

koban skill install teaches Claude Code, Codex, Cursor, and any AGENTS.md-aware tool to drive koban — so your agent tracks work in Invoice Ninja automatically, with guarded writes it always previews first.

One durable command shape

Every resource family follows the same verbs — list, show, template, edit-template, create, update, delete, bulk, action, upload — across clients, invoices, payments, quotes, and 30+ more.

Built for humans and agents

Comfy table output by default; --output json emits a stable shape for pipelines, grep, and jq. Errors are explicit and never print your token.

Guarded writes

Mutations require --yes, and --dry-run previews the exact request before anything leaves your machine. Inspect-only resources never expose write verbs.

A real client library too

cargo add koban gives you a typed Invoice Ninja client — ApiClient, Config::from_env(), and forward-compatible models that preserve unknown fields.

Shell completions everywhere

Generate completions for bash, zsh, fish, nushell, elvish, and PowerShell straight from the binary.

Single binary, easy install

curl | sh installer with checksum verification, cargo install koban-cli, or nix run. Self-update with koban update, including nightly builds.

At a glance

# Point koban at the public Invoice Ninja demo API.
export INVOICE_NINJA_BASE_URL="https://demo.invoiceninja.com"
export INVOICE_NINJA_API_TOKEN="TOKEN"

koban clients list --per-page 20
koban invoices list --filter status_id=gt:1 --sort 'date|desc' --all
koban invoices show <id> --output json | jq '.data.balance'

# Writes are guarded: preview first, then confirm.
koban invoices create --client-id <id> \
  --line-item product_key=Consulting,quantity=1,cost=100 --dry-run
koban invoices action <id> --action mark_paid --yes

Use it as a library from any Rust app:

rust

use koban::{ApiClient, Config};

#[tokio::main]
async fn main() -> koban::Result<()> {
    let client = ApiClient::new(Config::from_env()?);
    for invoice in client.invoices().list().await? {
        println!("{} -> {}", invoice.number, invoice.balance);
    }
    Ok(())
}

Track your work automatically with AI agents

Install koban as a skill and your coding agent drives it for you:

koban skill install --target all

Now an agent can log billable tasks and time, draft and send invoices, record expenses, and report on outstanding balances in Invoice Ninja as it works — using koban's stable JSON and its --dry-run/--yes safety gates so every write is previewed first. Works with Claude Code, OpenAI Codex CLI, pi, Cursor, Claude Desktop, and any AGENTS.md-aware tool.

kobanInvoice Ninja from the terminal