Ambush Streams for Hermes Agent

The official Ambush AI profile distribution for Hermes Agent. It connects Hermes to the production Ambush Streams MCP server through OAuth and bundles the same stream-management skill used by the Ambush integrations for other agent hosts.

Install

Install Hermes Agent 0.20.0 or newer, then run:

hermes profile install github.com/Ambush-AI/hermes-profile --alias

If this is your first Hermes profile, select a model provider:

ambush-streams model

Connect your Ambush account through OAuth:

ambush-streams mcp login ambush-streams

Start the agent:

ambush-streams chat

Hermes stores OAuth tokens inside the installed profile. Do not paste Ambush tokens into config files, chat messages, or issue reports.

Try it

• “Create a stream for material cybersecurity incidents affecting Canadian banks.”
• “Pause my AI regulation stream.”
• “Show the five latest items from my semiconductor supply-chain stream.”
• “For every event from that stream, produce a trade thesis or no-trade result and send it to my Trade Ideas Slack channel.”

The agent can create, list, inspect, rename, update, pause, resume, and permanently delete streams; configure per-event processing; route streams to existing connected destinations; and review emitted news.

The MCP API still exposes legacy tool names such as list_feeds and create_feed. The bundled skill maps those identifiers to Ambush Streams terminology. Permanent deletion always requires explicit confirmation of the exact stream.

MCP-only installation

If you want Ambush tools in an existing Hermes profile without installing the dedicated agent, connect the hosted MCP server directly:

hermes mcp add ambush-streams \
  --url https://api.ambush.ai/mcp \
  --auth oauth

Hermes will open the OAuth flow, discover the available tools, and let you choose which ones to enable.

Update or remove

Update the profile while preserving its local credentials, memories, sessions, and model configuration:

hermes profile update ambush-streams

Remove the profile and its local data:

hermes profile delete ambush-streams

Related Ambush integrations

• Agent skill package
• Claude Code plugins
• Codex plugins

Development

Validate the repository:

python3 -m pip install 'PyYAML>=6,<7'
python3 scripts/validate_profile.py

Then smoke-test an isolated local installation with a current Hermes checkout:

HERMES_HOME="$(mktemp -d)" hermes profile install . --name ambush-streams-test --yes

License

MIT. See LICENSE.