![\"triflux\"](\"docs/assets/logo-dark.svg\"){kind=logo}
\n \n \n
\n One front door for routing work, coordinating agents, running local/remote teams,
\n and keeping Codex/Antigravity/Claude execution behind auditable guards.\n
\n ![\"npm](\"https://img.shields.io/npm/v/triflux?style=flat-square&color=FFAF00&label=npm\")
![\"npm](\"https://img.shields.io/npm/dm/triflux?style=flat-square&color=F5C242\")
![\"GitHub](\"https://img.shields.io/github/stars/tellang/triflux?style=flat-square&color=FFAF00\")
![\"34](\"https://img.shields.io/badge/skill_files-34-F5C242?style=flat-square\"){kind=icon}
![\"Node](\"https://img.shields.io/badge/node-%3E%3D18-374151?style=flat-square\"){kind=icon}
![\"License:](\"https://img.shields.io/badge/License-MIT-374151?style=flat-square\"){kind=icon}
\n ![\"triflux](\"docs/assets/demo-multi.gif\")
\n
\n Quick Start ·\n Current Surface ·\n Canonical Workflows ·\n Architecture ·\n Operations ·\n Security\n
\n\n---\n\n## What is triflux?\n\ntriflux is a **Claude Code plugin + npm CLI** for routing AI coding work across\nClaude, Codex, and Antigravity without letting ad-hoc shell commands or stale skill\naliases become the control plane.\n\nThe current design is intentionally simpler than the old README implied:\n\n- **`/tfx-auto` is the canonical Claude Code skill front door.** Use flags to\n express quick/deep/consensus/parallel/retry behavior.\n- **`tfx` is the shell CLI.** Use it for setup, diagnostics, hub lifecycle,\n MCP sync, team/swarm orchestration, and handoffs.\n- **Compatibility aliases still exist, but they are not the primary API.** They\n are documented in [`docs/legacy-skill-aliases.md`](https://github.com/tellang/triflux/blob/main/docs/legacy-skill-aliases.md)\n so the main README stays focused on the supported path.\n- **Host-local Codex harnesses are out of package scope.** For example, a local\n `~/.codex/skills/tfx-harness` can recommend workflows on one machine, but it\n is not shipped in this repository, npm package, or Claude plugin.\n\n---\n\n## Quick Start\n\n### 1. Install\n\nClaude Code plugin install:\n\n```text\n/plugin marketplace add tellang/triflux\n/plugin install triflux@tellang\n```\n\nnpm install:\n\n```bash\nnpm install -g triflux\n```\n\nThen run the setup/diagnostic path from a terminal:\n\n```bash\ntfx setup\ntfx doctor\n```\n\nUse `tfx doctor --json` when you need machine-readable status for automation.\n\n### 2. Use the canonical front doors\n\nClaude Code slash skills:\n\n```text\n/tfx-auto \"review this change\" --mode consensus\n/tfx-auto \"implement auth flow with tests\" --mode deep --retry ralph\n/tfx-auto \"split this PRD across isolated shards\" --parallel swarm --mode consensus --isolation worktree\n/tfx-remote spawn ryzen5-7600 \"run a security review\"\n/tfx-doctor\n```\n\nShell CLI:\n\n```bash\ntfx list\ntfx hub ensure\ntfx mcp list\ntfx handoff --target remote --output .omx/handoff.md\ntfx swarm preflight docs/prd/example.md --json\ntfx codex-team \"refactor auth + add tests\"\n```\n\n> Deep, consensus, team, and swarm paths need the relevant CLIs and a terminal\n> multiplexer. Run `tfx doctor` first; it reports missing Codex/Antigravity/Claude,\n> psmux/tmux, Hub, MCP, profile, and stale-skill issues.\n\n---\n\n## Current Surface\n\n### Shell commands\n\nThe `tfx` CLI currently exposes these primary commands:\n\n| Command | Use |\n| --- | --- |\n| `tfx setup` | Sync scripts, HUD, hooks, MCP, and profiles. Supports `--dry-run`. |\n| `tfx doctor` | Diagnose and repair installation state. Supports `--fix`, `--reset`, `--diagnose`, `--json`. |\n| `tfx auto` | Preview the `tfx-auto` routing decision. Supports `--cli`, `--mode`, `--parallel`, `--json`. |\n| `tfx mcp` | Manage MCP registry targets with `list`, `sync`, `add`, and `remove`. |\n| `tfx hub` | Start, stop, ensure, or inspect the local MCP message bus. |\n| `tfx list` | Show installed package and user skills. |\n| `tfx handoff` | Serialize the current context for local or remote continuation. |\n| `tfx schema` | Print CLI and Hub delegator schemas. |\n| `tfx hooks` | Scan, diff, apply, restore, or inspect hook orchestrator state. |\n| `tfx tray` | Start the tray/HUD status process; use `--attach` for foreground debugging. |\n| `tfx multi` | Launch local multi-agent team mode through tmux/psmux + Hub. |\n| `tfx swarm` | Plan, preflight, run, or list PRD-based worktree-isolated swarm work. |\n| `tfx synapse` | Inspect swarm registry and leases. |\n| `tfx review` | Run Codex-backed git diff review. |\n| `tfx codex-team` | Codex-led team mode convenience wrapper. |\n| `tfx notion-read` | Convert Notion pages to Markdown through configured MCP clients. |\n| `tfx why` | Read intent trailers from the last commit touching a path. |\n| `tfx update` | Update to the latest stable or dev package. |\n| `tfx monitor` | Open the terminal TUI monitor. |\n| `tfx version` | Print version information. |\n| `tfx-profile` | Convenience binary for interactive Codex profile management. |\n\nRun `tfx schema\n ![\"triflux](\"docs/assets/architecture.svg\")
\n
\n MIT License · Made by tellang\n
\n","readmeFilename":"README.md"}