ainb-fleetbridge

Solid

Native phone bridge — relay messages two-way between a chat channel (Telegram, Slack, and/or Discord) and your ainb sessions. Inbound chat messages route to a target session (by `name:` prefix, else a conductor- first default) and are delivered via tmux send-keys; the session's reply is captured from its JSONL transcript and sent back to the chat. Config lives in ~/.agents-in-a-box/config/config.toml under [fleet.bridge.*]; tokens resolve from $ENV / keychain refs and are NEVER passed on argv. Use to run, install, or check the bridge — this is the channel ATC pages you through.

AI & Automation 18 stars 6 forks Updated today MIT

Install

View on GitHub

Quality Score: 78/100

Stars 20%
43
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# ainb fleet:bridge — native phone bridge A single-binary, two-way relay between a chat channel and your ainb fleet. It folds every channel into the ainb binary — there is no separate Python runtime to install or manage. Three channels share ONE relay/routing core over one transport: - **Telegram** — long-polling `getUpdates` over HTTP. - **Slack** — socket-mode WebSocket. - **Discord** — raw Gateway WebSocket. ``` chat message ──▶ bridge ──parse target──▶ tmux send-keys ──▶ ainb session reply ◀── bridge ◀──capture from JSONL transcript tail ◀──┘ ``` This is ATC's voice to you: when ATC escalates, the `NEED: …` line surfaces in whichever channel the bridge runs. ## Subcommands ```bash ainb fleet bridge run # start the daemon (default if no subcommand) ainb fleet bridge install # install as a launchd/systemd service (idempotent) ainb fleet bridge uninstall # remove the service unit (returns the removed path, if any) ainb fleet bridge status # report INSTALL state of the service unit ``` `run` loads the config and drives every configured channel concurrently; it runs until the process is stopped. `bridge` with no subcommand is the same as `bridge run`. > **`status` reports INSTALL state, not liveness.** For "is the bridge actually > running and connected right now?" use [`/ainb-fleet:daemons`](../daemons/SKILL.md) > — its heartbeat-backed probe distinguishes a live+connected bridge from a > crashed one (stale heartbeat / recycled pid...

Details

Author
stevengonsalvez
Repository
stevengonsalvez/agents-in-a-box
Created
1 years ago
Last Updated
today
Language
Rust
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Solid

ainb-fleet

Fleet orchestration overview — the `ainb fleet ...` Rust subcommand namespace for driving every claude session on the host. Routes to the sub-skills (standup / broadcast / sequence / needs / daemon / atc). Invoke this for an at-a-glance map of what fleet can do; reach for the specific sub-skill for the verb you want.

18 Updated today
stevengonsalvez
AI & Automation Solid

ainb-fleetdaemons

Runtime-health view of the four fleet daemons — phone bridge, notifyd, ATC, and the fleet auto-continue daemon — in one table. Each row reports state (running / stopped / unknown), pid, uptime, last activity, error count, and a HEALTH reason that distinguishes a clean stop from a crash (stale heartbeat) or a pid-recycle. Use this when you need to answer "are my background daemons actually alive?" — not just installed, but serving. Default output: a fixed-width text table. Pass --format json for tooling.

18 Updated today
stevengonsalvez
AI & Automation Solid

ainb-fleetatc

ATC (Air Traffic Control) — the persistent orchestrating brain of the fleet. A plain `ainb` Claude session running a generated CLAUDE.md policy, woken on an OS-timer heartbeat (default 15 min) built from the LLM-free `fleet needs` read — which is itself HOOKS-PRIMARY (event-sourced): ATC learns ASK/WAIT/IDLE from the materialized `current_state` table, not by scraping panes, with a tmux fallback for non-Claude agents. `atc setup` installs the global Claude Code hooks into ~/.claude/settings.json. It auto-clears the safe/blocked sessions via the fleet verbs (confident ASK → broadcast; ERR → continue within a retry cap) and escalates the uncertain ones to the phone bridge. Supersedes the `daemon` skill for managed fleets. Use to provision / inspect / tear down an ATC instance.

18 Updated today
stevengonsalvez