blowhorn-axi

The agent interface to Blowhorn. It gives AI agents a compact TOON view of Blowhorn actions: every answer ends with a help[] list of next commands, every write is a dry run unless you pass --confirm, and errors are structured records with exit codes 0 (ok), 1 (failed), 2 (usage) and 3 (Blowhorn's store unavailable).

Requirements

• macOS with Blowhorn installed: download it from https://blowhorn.ai/download, then run blowhorn setup and blowhorn auth login.
• Node.js 20 or later.

This package is a small launcher. The agent interface itself ships with the Blowhorn CLI; when Blowhorn is missing, blowhorn-axi says so as a TOON error whose help[] points to the install steps.

Install

npx blowhorn-axi            # run once without installing
npm install -g blowhorn-axi # or install the command

Quick start for agents

blowhorn-axi                                  # home: profiles and session readiness
blowhorn-axi profile list                     # every profile, its workspace and session
blowhorn-axi profile status --profile work    # one profile
blowhorn-axi slack send --profile work \
  --to https://example.slack.com/archives/C0123/p1776000000000100 \
  --text-file reply.md                        # dry run: shows what would be sent
blowhorn-axi slack send ... --confirm         # actually send

Text comes from --text - (stdin), --text-file <path> or --message, and Slack mrkdwn passes through untouched. --profile a,b sends as several profiles in turn, paced apart.

Safety model

• Dry run by default; nothing is written without --confirm.
• Slack writes use the person's own captured browser session only. A profile with only an app token is refused (token_only).
• No secrets in output: token-shaped text is redacted.
• No Slack reads (history, search, threads); blowhorn-axi only writes.
• A write whose child process hangs is stopped after 300 seconds and reported as outcome_unknown, never as a plain error.

Ambient context and the skill

blowhorn-axi setup hooks           # SessionStart hook for Claude Code, Codex and OpenCode
blowhorn-axi setup hooks --status  # what is installed, changes nothing
blowhorn-axi setup hooks --remove  # take the managed entries back out

The hook runs the blowhorn-axi home view at the start of every agent session, so the agent sees which profiles can send before it is asked. Running it again changes nothing, and hooks it did not write are left alone. Add --project to write them for the current project instead of your user.

Prefer a skill? The package ships one at skills/blowhorn-axi/SKILL.md, generated from the same help text the command prints. Copy it into your agent's skills folder. Use the hook or the skill; you need only one.

Updating

blowhorn-axi update            # reports whether a newer blowhorn-axi exists (dry run)
blowhorn-axi update --confirm  # installs it with npm install -g

update also checks that the Blowhorn CLI on this Mac still provides the interface, before and after updating. To update the Blowhorn app and CLI themselves, download the latest release from https://blowhorn.ai/download.

License

AGPL-3.0-only