> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bossmode.ing/llms.txt
> Use this file to discover all available pages before exploring further.

# Hermes Integration

> Connect BossMode to Hermes for orchestrated agent workflows with operational governance. Hermes handles the orchestration; BossMode handles the rules.

<Warning>🚧 Expanding soon — full Hermes integration documentation is in progress.</Warning>

## BossMode + Hermes

Hermes is an agent orchestration system. BossMode is the governance and revenue intelligence layer. Together, they give you orchestrated multi-agent workflows that operate within your standing orders and report back with receipts.

## Architecture

```
Boss (you)
  ↓  standing orders + directives
BossMode consigliere
  ↓  bound, governed work packets
Hermes orchestration
  ↓  routes to appropriate agents
Agent execution
  ↓  moves logged, approvals queued
BossMode audit feed → Daily Report
```

## Integration setup

The Hermes-BossMode bridge is configured via environment variables in your Hermes workspace:

```bash theme={null}
BOSSMODE_API_TOKEN=bm_live_your_token
BOSSMODE_GOVERNANCE=true
BOSSMODE_REQUIRE_APPROVAL_DEFAULT=true
```

With `BOSSMODE_GOVERNANCE=true`, every Hermes agent run:

1. Pulls BossMode standing orders before execution
2. Checks Guardian state before proceeding
3. Logs the move to the BossMode audit feed
4. Queues output for approval if required

## Pulling context in Hermes

```javascript theme={null}
// In a Hermes workflow step
const bossmode = require('@acelabs/bossmode-hermes-bridge');

const context = await bossmode.getContext();
// context.standingOrders, context.buyerProfiles, context.signals, etc.
```

## Logging moves back

```javascript theme={null}
await bossmode.logMove({
  capo: 'capo_ops',
  action: 'delivery-milestone-logged',
  description: 'Client delivery milestone confirmed for Q2 project',
  metadata: { clientId: 'client_abc', milestone: 'phase-1-complete' }
});
```

## Requirements

* Hermes v1.2.0 or higher
* BossMode Pro account
* `BOSSMODE_API_TOKEN` set in Hermes environment