triflux

English | 한국어

CLI-first multi-model orchestration for Claude Code, Codex, and Antigravity

One front door for routing work, coordinating agents, running local/remote teams,
and keeping Codex/Antigravity/Claude execution behind auditable guards.

_{11 compatibility aliases are deprecated}

Quick Start · Current Surface · Canonical Workflows · Architecture · Operations · Security

---

What is triflux?

triflux is a Claude Code plugin + npm CLI for routing AI coding work across Claude, Codex, and Antigravity without letting ad-hoc shell commands or stale skill aliases become the control plane.

The current design is intentionally simpler than the old README implied:

• /tfx-auto is the canonical Claude Code skill front door. Use flags to express quick/deep/consensus/parallel/retry behavior.
• tfx is the shell CLI. Use it for setup, diagnostics, hub lifecycle, MCP sync, team/swarm orchestration, and handoffs.
• Compatibility aliases still exist, but they are not the primary API. They are documented in docs/legacy-skill-aliases.md so the main README stays focused on the supported path.
• Host-local Codex harnesses are out of package scope. For example, a local ~/.codex/skills/tfx-harness can recommend workflows on one machine, but it is not shipped in this repository, npm package, or Claude plugin.

---

Quick Start

1. Install

Claude Code plugin install:

/plugin marketplace add tellang/triflux
/plugin install triflux@tellang

npm install:

npm install -g triflux

Then run the setup/diagnostic path from a terminal:

tfx setup
tfx doctor

Use tfx doctor --json when you need machine-readable status for automation.

2. Use the canonical front doors

Claude Code slash skills:

/tfx-auto "review this change" --mode consensus
/tfx-auto "implement auth flow with tests" --mode deep --retry ralph
/tfx-auto "split this PRD across isolated shards" --parallel swarm --mode consensus --isolation worktree
/tfx-remote spawn ryzen5-7600 "run a security review"
/tfx-doctor

Shell CLI:

tfx list
tfx hub ensure
tfx mcp list
tfx handoff --target remote --output .omx/handoff.md
tfx swarm preflight docs/prd/example.md --json
tfx codex-team "refactor auth + add tests"

Deep, consensus, team, and swarm paths need the relevant CLIs and a terminal multiplexer. Run tfx doctor first; it reports missing Codex/Antigravity/Claude, psmux/tmux, Hub, MCP, profile, and stale-skill issues.

---

Current Surface

Shell commands

The tfx CLI currently exposes these primary commands: