# thalix-auto

[![npm version](https://img.shields.io/npm/v/tap-skill?color=cb3837)](https://www.npmjs.com/package/tap-skill)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)

**Multi-agent orchestration as an installable skill — for Claude Code, Codex CLI, and Pi (pi.dev).**

Slash commands surface as `/tap:<name>` in Claude Code and `/tap-<name>` in Pi. The skill ships 19 specialized agents, 38 workflow skills (autopilot, ralph, ultrawork, team, …), an MCP toolbox, and a tmux-based multi-CLI team runtime.

This is a personal, rebranded fork of [**oh-my-claudecode**](https://github.com/Yeachan-Heo/oh-my-claudecode) with a Pi adapter added. See [`UPSTREAM.md`](UPSTREAM.md) for attribution and resync workflow.

---

## Install

### Claude Code (plugin marketplace)

```text
/plugin marketplace add https://github.com/manateeit/thalix-auto
/plugin install tap
```

Slash commands then appear as `/tap:setup`, `/tap:autopilot`, `/tap:ralph`, etc.

### npx (any supported CLI)

```bash
# auto-detect Claude Code, Pi, and Codex CLI and install adapters into each
npx tap-skill add

# or scope to one target
npx tap-skill add --target=pi
npx tap-skill add --target=claude
npx tap-skill add --target=codex
```

### Pi (pi.dev) — native package install

```bash
pi install npm:tap-skill
```

Pi reads the `pi.{skills,prompts,extensions}` manifest in `package.json` and discovers everything automatically. Prompts appear as `/tap-setup`, `/tap-autopilot`, …

### Global CLI

```bash
npm i -g tap-skill
tap --help
tap-skill --help
```

---

## What's in the box

| Surface | Count | Examples |
|---|---|---|
| Slash commands | 28 | `/tap:setup`, `/tap:autopilot`, `/tap:ralph`, `/tap:ultrawork`, `/tap:team`, `/tap:plan`, `/tap:verify`, `/tap:trace`, … |
| Agents | 19 | `executor`, `architect`, `planner`, `code-reviewer`, `security-reviewer`, `verifier`, `tracer`, `debugger`, `writer`, `designer`, … |
| Skills | 38 | `autopilot`, `ralph`, `ultrawork`, `team`, `tap-reference`, `tap-setup`, `tap-doctor`, `tap-teams`, … |
| MCP servers | 1 | Bundled MCP toolbox at `.mcp.json` |
| Hooks | many | PreToolUse, PostToolUse, Stop, PreCompact — see `hooks/` |

Full catalog: see the `tap-reference` skill or run `tap --help`.

---

## Slash-command syntax across runtimes

| Runtime | Syntax | Example |
|---|---|---|
| Claude Code | `/tap:<name>` (plugin-namespaced) | `/tap:autopilot Build me a CLI…` |
| Pi (pi.dev) | `/tap-<name>` (flat namespace) | `/tap-autopilot Build me a CLI…` |
| Codex CLI | invoked via `tap` CLI or via `AGENTS.md` skill references | `tap autopilot` |

The body of every command is identical across runtimes — only the discovery layer differs.

---

## CLI reference (abridged)

```text
tap                     # interactive launcher
tap --version
tap --help

tap setup               # configure adapters for installed CLIs
tap doctor              # diagnose install / config issues
tap teams               # multi-CLI tmux team orchestration

tap-skill add [...]     # installer (see Install section above)
tap-skill remove
tap-skill doctor
```

---

## Status dirs and env vars

- Project state: `.tap/` (per-project session, plans, logs)
- Global state: `~/.tap/`
- Kill switches: `DISABLE_TAP=1`, `TAP_SKIP_HOOKS=<comma-separated>`
- Plugin root override: `TAP_PLUGIN_ROOT=/path/to/checkout`

---

## Credit

All architectural credit for the orchestrator, agent definitions, skill bodies, HUD, hooks, MCP toolbox, and team bridge belongs to **Yeachan Heo** and the [oh-my-claudecode contributors](https://github.com/Yeachan-Heo/oh-my-claudecode). thalix-auto is a personal rebrand plus a Pi adapter on top of their work, MIT-licensed identically.

If you find this useful upstream, please star [oh-my-claudecode](https://github.com/Yeachan-Heo/oh-my-claudecode).

## License

MIT — see [`LICENSE`](LICENSE).