Hermes Agent uses Ditto through a Hermes skill that calls the Ditto CLI. This is separate from MCP setup.
Before You Start
You need Hermes Agent installed.
You can create your Ditto account during the connection flow.
Install The Skill
Add the Ditto skill tap, then install the skill:
hermes skills tap add ditto-assistant/ditto-hermes
hermes skills install ditto-assistant/ditto-hermes/ditto
The skill source is ditto-assistant/ditto-hermes. Hermes’ skill system supports GitHub taps, so the tap command subscribes Hermes to that repository and the install command pulls the ditto skill from it.
If you need to verify or repair the CLI directly, use the Ditto CLI docs.
Create A Key
Hermes prompts for the required DITTO_API_KEY during skill setup.
- Open app.heyditto.ai/connect/hermes.
- Sign in.
- Create a new key and copy it.
- Paste it into the Hermes prompt.
The app connect page for this integration is app.heyditto.ai/connect/hermes.
If you missed the prompt or need to rotate the value:
hermes skills config ditto
Verify
Check the CLI can reach Ditto:
ditto status
Then make a real account-backed request:
ditto subjects "test" --output json
Hermes can now use Ditto memory when the conversation calls for it. See Ditto CLI verification for the standalone command output shape.
Troubleshooting
| Symptom | Fix |
|---|---|
hermes skills tap add fails | Confirm Hermes can reach GitHub and the tap URL ditto-assistant/ditto-hermes is typed exactly. |
ditto: command not found | Use the manual repair steps in Ditto CLI troubleshooting. |
| Hermes did not ask for the API key | Run hermes skills config ditto to re-open the skill config prompt. |
error: no Ditto API key configured | Re-run hermes skills config ditto, or create a key at app.heyditto.ai/connect/hermes and run ditto login <key>. |
| Requests fail after working previously | Run ditto status. If the key was revoked, rotate it with ditto logout followed by ditto login <new-key>, then update Hermes with hermes skills config ditto. |