README
¶
Takt AI
Takt AI is a meta-harness for AI coding assistants.
It's not a standalone agent, an LLM, or a simple collection of prompt plugins. It operates a level deeper as an integration layer that sits between your local workspace and your AI tooling. It orchestrates the context, boundaries, and persistent state that raw coding assistants usually lack.
Supported Agents
Takt AI integrates directly with coding agents:
- OpenCode
Status
Pre-v1. Releases are stable, but features planned for v1 are still being added and refined.
Platforms
| Platform | Support |
|---|---|
| macOS ARM64 | Supported |
| Linux | Supported |
| macOS Intel | Expected to work, not validated |
| WSL | Expected to work through Linux compatibility, not validated |
| Windows | Not supported |
Install
Linux/macOS
curl -fsSL https://raw.githubusercontent.com/rou-cru/takt-ai/main/install.sh | bash
Homebrew
brew tap rou-cru/homebrew-takt-ai
brew install --cask rou-cru/takt-ai/takt-ai
Go
Note: The binary is named "cli"; install.sh --method go renames it.
go install github.com/rou-cru/takt-ai/takt/cli@latest
Manual
Linux .deb, .rpm, .apk and Arch packages are attached to every release, together with SBOMs and signatures.
Docker & Kubernetes
Plug & play without changing your current tools. Great for isolated testing, trials, or working on the go.
docker run --rm -p 4096:4096 -e OPENCODE_PASSWORD=change-me -v "$PWD:/workspace" roucru/takt-ai:latest
Image options, environment variables and tags: workspace image.
Enterprise-grade. Provides Takt AI as a standard environment for organizations and engineering teams.
helm install demo oci://ghcr.io/rou-cru/charts/takt-ai --namespace takt-workspaces --create-namespace
Values and prerequisites: Helm chart.
Managed per-human workspaces. Optional, for teams that already run Coder.
Each person gets their own isolated Kubernetes workspace, provisioned and owned through their Coder account, and works from the terminal. Coder is optional: without it, the local install, the Docker image, and the Helm chart above work unchanged.
Template deployment and terminal workflow: Coder workspaces.
Usage
Run takt-ai and choose Install. The TUI guides the rest.
Documentation
License
Directories
¶
| Path | Synopsis |
|---|---|
|
development
|
|
|
generate-logo
command
Package main rebuilds logo data so TUI branding stays matched to the canonical PNG.
|
Package main rebuilds logo data so TUI branding stays matched to the canonical PNG. |
|
takt
|
|
|
agents/opencode
Package opencode renders native OpenCode configuration from catalog references.
|
Package opencode renders native OpenCode configuration from catalog references. |
|
agents/shared
Package shared holds helpers reused by the OpenCode target adapter.
|
Package shared holds helpers reused by the OpenCode target adapter. |
|
catalog
Package catalog is the single declarative source of Takt's installable content: agent definitions, skill packages, shared files and the versioned install manifest.
|
Package catalog is the single declarative source of Takt's installable content: agent definitions, skill packages, shared files and the versioned install manifest. |
|
cli
command
Package main runs the takt-ai command so users can drive setup from a terminal or scripts.
|
Package main runs the takt-ai command so users can drive setup from a terminal or scripts. |
|
codegraph
Package codegraph keeps the codebase-exploration MCP wiring in one place so every agent target shares the same setup and checks.
|
Package codegraph keeps the codebase-exploration MCP wiring in one place so every agent target shares the same setup and checks. |
|
dispatch
Package dispatch is the generic admission and lifecycle protocol for any unit of work an orchestrator dispatches, backed by the execution history projection.
|
Package dispatch is the generic admission and lifecycle protocol for any unit of work an orchestrator dispatches, backed by the execution history projection. |
|
doctor
Package doctor implements the `takt-ai doctor` system health check: tool availability in PATH, ownership-manifest deployment state, engram reachability, and free disk space.
|
Package doctor implements the `takt-ai doctor` system health check: tool availability in PATH, ownership-manifest deployment state, engram reachability, and free disk space. |
|
engram
Package engram keeps memory-server wiring in one place so every agent target shares the same setup and checks.
|
Package engram keeps memory-server wiring in one place so every agent target shares the same setup and checks. |
|
gc
Package gc computes and coordinates the workspace GC cycle: it decides when a cycle starts, declares its plan, and runs preparation, analysis, investigation, barrier and acceptance phases.
|
Package gc computes and coordinates the workspace GC cycle: it decides when a cycle starts, declares its plan, and runs preparation, analysis, investigation, barrier and acceptance phases. |
|
history
Package history keeps the execution history: the append-only, totally ordered record from which the execution DAG is derived by replay (PR-DAG-REP-1).
|
Package history keeps the execution history: the append-only, totally ordered record from which the execution DAG is derived by replay (PR-DAG-REP-1). |
|
internal/artifacts
Package artifacts normalizes relative paths shared by agent-file renderers and the deployer.
|
Package artifacts normalizes relative paths shared by agent-file renderers and the deployer. |
|
internal/filemerge
Package filemerge merges Takt-managed content into user-owned JSON, TOML, and markdown configuration files so user edits survive deploys.
|
Package filemerge merges Takt-managed content into user-owned JSON, TOML, and markdown configuration files so user edits survive deploys. |
|
internal/flock
Package flock takes exclusive advisory file locks with a bounded wait.
|
Package flock takes exclusive advisory file locks with a bounded wait. |
|
internal/opencodeapi
Package opencodeapi is Takt's single adapter to the OpenCode v2 HTTP API.
|
Package opencodeapi is Takt's single adapter to the OpenCode v2 HTTP API. |
|
lifecycle
Package lifecycle dispatches the install, sync and uninstall orchestration shared by the CLI (takt/cli) and the TUI runtime, composing setup, skills and engram.
|
Package lifecycle dispatches the install, sync and uninstall orchestration shared by the CLI (takt/cli) and the TUI runtime, composing setup, skills and engram. |
|
memory
Package memory writes agent memories into Engram with harness-owned metadata, links and session anchors.
|
Package memory writes agent memories into Engram with harness-owned metadata, links and session anchors. |
|
model
Package model keeps one shared vocabulary for agents, components, and assignments so adapters never drift apart.
|
Package model keeps one shared vocabulary for agents, components, and assignments so adapters never drift apart. |
|
obs
Package obs keeps one local event stream and control record so sessions stay observable without network or memory coupling.
|
Package obs keeps one local event stream and control record so sessions stay observable without network or memory coupling. |
|
session
Package session is the composition root of one crew execution session: it owns the session clock, the control bus and the VFS, and wires the VFS's Takt-native signals onto the bus.
|
Package session is the composition root of one crew execution session: it owns the session clock, the control bus and the VFS, and wires the VFS's Takt-native signals onto the bus. |
|
setup
Package setup implements the install, sync, and uninstall lifecycle: it builds target plans from a request, deploys rendered artifacts with transactional rollback, and tracks ownership through a persistent manifest.
|
Package setup implements the install, sync, and uninstall lifecycle: it builds target plans from a request, deploys rendered artifacts with transactional rollback, and tracks ownership through a persistent manifest. |
|
setup/testutil
Package testutil provides shared test helpers for setup and CLI test suites.
|
Package testutil provides shared test helpers for setup and CLI test suites. |
|
skills
Package skills implements the skill deployment lifecycle: it loads skill definitions from the catalog, renders them as deployment artifacts, and tracks ownership through the shared setup manifest.
|
Package skills implements the skill deployment lifecycle: it loads skill definitions from the catalog, renders them as deployment artifacts, and tracks ownership through the shared setup manifest. |
|
skills/testutil
Package testutil provides shared test helpers for skills-related test suites.
|
Package testutil provides shared test helpers for skills-related test suites. |
|
tui
Package tui composes Takt's interactive lifecycle flows.
|
Package tui composes Takt's interactive lifecycle flows. |
|
tui/diagnostics
Package diagnostics presents functional checks without reinstalling.
|
Package diagnostics presents functional checks without reinstalling. |
|
tui/drift
Package drift shows which managed files differ from their installed definition and restores only the files the user selects.
|
Package drift shows which managed files differ from their installed definition and restores only the files the user selects. |
|
tui/install
Package install provides the focused install selection flow.
|
Package install provides the focused install selection flow. |
|
tui/keys
Package keys defines the global keyboard grammar for TUI flows.
|
Package keys defines the global keyboard grammar for TUI flows. |
|
tui/modelpicker
Package modelpicker edits one harness's specialist model drafts.
|
Package modelpicker edits one harness's specialist model drafts. |
|
tui/models
Package models lets the user reassign specialists' models after install, keeping the rest of a custom installation.
|
Package models lets the user reassign specialists' models after install, keeping the rest of a custom installation. |
|
tui/runtime
Package runtime provides Bubble Tea lifecycle action boundaries.
|
Package runtime provides Bubble Tea lifecycle action boundaries. |
|
tui/styles
Package styles renders the Takt brand logo for the TUI from generated data.
|
Package styles renders the Takt brand logo for the TUI from generated data. |
|
tui/testutil
Package testutil provides shared test helpers for the TUI test suites.
|
Package testutil provides shared test helpers for the TUI test suites. |
|
tui/theme
Package theme is the single source of visual truth for the TUI: renderers ask for a role (TextPrimary, SuccessFg, Caption), never a hex or palette name.
|
Package theme is the single source of visual truth for the TUI: renderers ask for a role (TextPrimary, SuccessFg, Caption), never a hex or palette name. |
|
tui/ui
Package ui contains reusable terminal UI primitives.
|
Package ui contains reusable terminal UI primitives. |
|
tui/uninstall
Package uninstall provides the target-scoped managed-file uninstall screen.
|
Package uninstall provides the target-scoped managed-file uninstall screen. |
|
verify
Package verify collects functional evidence without invoking agent tools or authentication.
|
Package verify collects functional evidence without invoking agent tools or authentication. |
|
vfs
Package vfs implements the Virtual File System, the transactional execution layer for agent file operations.
|
Package vfs implements the Virtual File System, the transactional execution layer for agent file operations. |
Click to show internal directories.
Click to hide internal directories.