Référence du Takuto CLI

Le Takuto CLI est l’outil compagnon de Takuto Core : il génère vos fichiers de config, orchestre Docker Compose et déroule les flux d’authentification. Il est sous licence MIT et encapsule le même moteur que vous feriez tourner à la main autrement.

Installation

Homebrew (macOS / Linux — recommandé) :

brew install takuto-team/tap/takuto

Téléchargement manuel du binaire. Récupérez le binaire pour votre plateforme depuis la page des 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

Sous Windows, téléchargez takuto-windows-amd64.exe et ajoutez-le à votre PATH.

Le CLI a besoin de Docker ou Podman installé — il détecte automatiquement celui dont vous disposez, y compris les alias.

Commandes

Le CLI compte cinq sous-commandes.

`takuto setup`

Lance l’assistant de configuration interactif. La majeure partie de la configuration vit désormais dans le dashboard, donc l’assistant est court — il ne vous demande que le port du dashboard et, si vous utilisez une base de données externe (Postgres / MySQL / MariaDB), ses détails de connexion (sinon il bascule par défaut sur le SQLite intégré). Il génère takuto.yml ainsi qu’un répertoire .takuto/ contenant config.toml, takuto.env et un dossier workflows/ avec les trois définitions de workflow de départ. Les fichiers sont créés dans le répertoire courant — il n’a pas besoin d’être un dossier de projet, et lancer setup dans différents répertoires garde côte à côte des instances Takuto isolées.

takuto setup

my-project/
  takuto.yml                  # orchestration Docker Compose
  .takuto/
    config.toml                # configuration du projet
    takuto.env                # secrets et tokens API
    workflows/                 # définitions des étapes du pipeline
      implement_ticket.toml
      merge_base.toml
      address_pr_comments.toml

`takuto auth`

Optionnel — non recommandé. Déroule des flux de connexion OAuth interactifs à l’intérieur du container :

GitHub CLI (gh) — pour pousser des branches et créer des PR.
Votre fournisseur d’IA — Claude Code, Cursor Agent, Codex ou OpenCode (auto-hébergé).
Clonage du dépôt — clone votre projet dans l’espace de travail du container.

L’OAuth accorde un accès large au compte ; la voie recommandée est donc plutôt des clés API / tokens à portée limitée : définissez les identifiants de votre fournisseur (par ex. ANTHROPIC_API_KEY, CURSOR_API_KEY, OPENAI_API_KEY) et un GH_TOKEN à portée limitée dans .takuto/takuto.env, ou saisissez-les depuis le dashboard — voir Configuration pour la liste complète. N’utilisez takuto auth que si vous avez spécifiquement besoin du flux de connexion interactif.

`takuto start`

Démarre les services Takuto Core et le dashboard.

takuto start

Ouvrez http://localhost:8080. Au premier démarrage, créez le compte admin initial. Si Jira ou GitHub Issues sont configurés, le polling démarre automatiquement ; sinon, cliquez sur + pour lancer un workflow manuellement.

`takuto stop`

takuto stop

Arrête les services Takuto (un docker compose down). L’état d’authentification, les snapshots de workflow et les caches persistent dans des volumes Docker nommés.

`takuto restart`

takuto restart

Redémarre les services. Les workflows en pause ou en cours reprennent depuis l’état sauvegardé.

Isolation multi-projets

Docker Compose préfixe chaque volume avec le nom du répertoire (par ex. my-app_claude-auth, my-app_workspace). Pour faire tourner Takuto sur plusieurs projets à la fois, utilisez un répertoire distinct par projet — chacun obtient une authentification, un espace de travail et des caches totalement isolés, sans configuration supplémentaire.

Presets d’exemple

Le dépôt Takuto fournit des presets autonomes que vous pouvez copier plutôt que de lancer l’assistant de zéro :

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

Chaque preset inclut une commande d’install ajustée, des commandes de run câblées au dashboard et des valeurs mise/port sensées. Copiez le dossier, éditez config.toml (les valeurs marquées ← — URL du dépôt, branche, système de ticketing), et démarrez comme d’habitude :

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

Notes sur les presets :

react-vite — install npm ci ; transfert de port dynamique pour Vite (5173) et Storybook (6006).
ruby-rails — bundle install ; Ruby 3.3 installé automatiquement via mise à la première ouverture de l’éditeur (ou votre .ruby-version / .tool-versions s’il est présent) ; le serveur Rails se lie à 0.0.0.0 pour que le transfert de port fonctionne. Ajoutez l’hôte de votre base de données à [network] extra_egress_hosts.
rust — cargo build ; la toolchain Rust est déjà intégrée à l’image.

Configuration manuelle (sans le CLI)

Si vous préférez ne pas utiliser le CLI, copiez un preset et lancez Compose directement — voir la section Manual Setup du README Takuto, ou la page Installer Takuto Core pour faire tourner le moteur depuis les sources.