Referencia de la Takuto CLI

La Takuto CLI es la herramienta complementaria de Takuto Core: genera tus archivos de configuración, orquesta Docker Compose y ejecuta los flujos de autenticación. Está licenciada bajo MIT y envuelve el mismo motor que de otro modo ejecutarías a mano.

Instalación

Homebrew (macOS / Linux — recomendado):

brew install takuto-team/tap/takuto

Descarga manual del binario. Coge el binario para tu plataforma desde la página de Releases:

# macOS (Apple Silicon)
curl -L -o takuto https://github.com/takuto-team/takuto-cli/releases/latest/download/takuto-darwin-arm64
chmod +x takuto && sudo mv takuto /usr/local/bin/

# macOS (Intel) — takuto-darwin-amd64
# Linux (amd64)  — takuto-linux-amd64
# Linux (arm64)  — takuto-linux-arm64

En Windows, descarga takuto-windows-amd64.exe y añádelo a tu PATH.

La CLI necesita Docker o Podman instalado — detecta automáticamente cuál tienes, incluidos los alias.

Comandos

La CLI tiene cinco subcomandos.

`takuto setup`

Ejecuta el asistente de setup interactivo. La mayor parte de la configuración vive ahora en el dashboard, así que el asistente es corto — solo te pregunta por el puerto del dashboard y, si usas una base de datos externa (Postgres / MySQL / MariaDB), sus datos de conexión (si no, usa por defecto el SQLite integrado). Genera takuto.yml más un directorio .takuto/ con config.toml, takuto.env y una carpeta workflows/ que contiene las tres definiciones de workflow de inicio. Los archivos se crean en el directorio actual — no tiene por qué ser una carpeta de proyecto, y ejecutar el setup en distintos directorios mantiene instancias aisladas de Takuto una al lado de otra.

takuto setup

my-project/
  takuto.yml                  # Docker Compose orchestration
  .takuto/
    config.toml                # project configuration
    takuto.env                # secrets and API tokens
    workflows/                 # pipeline step definitions
      implement_ticket.toml
      merge_base.toml
      address_pr_comments.toml

`takuto auth`

Opcional — no recomendado. Ejecuta flujos de login OAuth interactivos dentro del container:

GitHub CLI (gh) — para empujar ramas y crear PRs.
Tu proveedor de IA — Claude Code, Cursor Agent, Codex u OpenCode (autoalojado).
Clonado del repositorio — clona tu proyecto en el workspace del container.

OAuth concede acceso amplio a la cuenta, así que la vía recomendada son los API keys/tokens acotados en su lugar: fija las credenciales de tu proveedor (p. ej. ANTHROPIC_API_KEY, CURSOR_API_KEY, OPENAI_API_KEY) y un GH_TOKEN acotado en .takuto/takuto.env, o introdúcelas desde el dashboard — consulta Configuración para ver la lista completa. Usa takuto auth solo si necesitas específicamente el flujo de login interactivo.

`takuto start`

Arranca los servicios de Takuto Core y el dashboard.

takuto start

Abre http://localhost:8080. En el primer arranque, crea la cuenta admin inicial. Si Jira o GitHub Issues están configurados, el sondeo empieza automáticamente; si no, haz clic en + para iniciar un workflow manualmente.

`takuto stop`

takuto stop

Detiene los servicios de Takuto (un docker compose down). El estado de auth, los snapshots de workflow y las cachés persisten en volúmenes de Docker con nombre.

`takuto restart`

takuto restart

Reinicia los servicios. Los workflows en pausa o en curso se reanudan desde el estado guardado.

Aislamiento multiproyecto

Docker Compose prefija cada volumen con el nombre del directorio (p. ej. my-app_claude-auth, my-app_workspace). Para ejecutar Takuto en varios proyectos a la vez, usa un directorio separado por proyecto — cada uno obtiene auth, workspace y cachés totalmente aislados sin configuración extra.

Presets de ejemplo

El repositorio de Takuto incluye presets autocontenidos que puedes copiar en lugar de ejecutar el asistente desde cero:

Preset	Stack	Run commands
`react-vite`	React + Vite	Dev Server, Storybook, Preview Build
`ruby-rails`	Ruby on Rails	Rails Server, Console, Sidekiq
`rust`	Rust	Run Server, tests con `cargo watch`

Cada preset incluye un comando de install afinado, run commands cableados al dashboard y valores por defecto sensatos de mise/puertos. Copia la carpeta, edita config.toml (los valores marcados con ← — URL del repo, rama, sistema de ticketing) y arranca como siempre:

cp -r examples/react-vite/ my-project && cd my-project
# edit .takuto/config.toml
docker compose -f takuto.yml run --rm -it takuto setup
docker compose -f takuto.yml up -d

Notas de los presets:

react-vite — install con npm ci; reenvío dinámico de puertos para Vite (5173) y Storybook (6006).
ruby-rails — bundle install; Ruby 3.3 autoinstalado vía mise al abrir el editor por primera vez (o tu .ruby-version / .tool-versions si está presente); el servidor de Rails se enlaza a 0.0.0.0 para que funcione el reenvío de puertos. Añade el host de tu base de datos a [network] extra_egress_hosts.
rust — cargo build; el toolchain de Rust ya viene horneado en la imagen.

Setup manual (sin la CLI)

Si prefieres no usar la CLI, copia un preset y ejecuta Compose directamente — consulta la sección de Setup manual en el README de Takuto, o la página Instalar Takuto Core para ejecutar el motor desde el código fuente.