Connect Ditto to Hermes Agent

Paste one prompt into Hermes: it installs the Ditto skill, signs itself up, and sends you a claim link. No API key required.

Hermes Agent uses Ditto through a skill that calls the Ditto CLI. You don’t need a Ditto account before you start; Hermes sets everything up itself and sends you a claim link.

Paste this into Hermes

The fastest path: hand the whole job to the agent.

Install the Ditto memory skill from its exact GitHub path:
  hermes skills install ditto-assistant/ditto-hermes/ditto
Install the CLI the skill needs:
  npm install -g @heyditto/cli@latest
Check existing authentication with: heyditto status --output json
If a key is already configured, reuse it. Do not log out or create a new account.
Otherwise create a claimable agent account:
  heyditto init --agent --agent-caller "hermes" --json
Send me only the claimURL from the response so I can claim the account.
Keep the full claim link private; never print the API key or local credential file.
Verify with: heyditto status --output json
Report the connection result and available tools. Do not create a test memory.
Help me add the Memory workflow instruction below without replacing my existing instructions.

Hermes installs the skill, creates a free account with the key stored locally (it is never printed), and replies with a claimURL. Open it, sign in, and the account is yours; the agent keeps its key and memories after you claim. See Agent-Native Signup for how the claim flow works.

Prefer to run the commands yourself?

Install the skill:

hermes skills install ditto-assistant/ditto-hermes/ditto

Install the CLI with npm install -g @heyditto/cli@latest, then run heyditto status --output json. Reuse a configured key. If none is configured, let Hermes sign itself up:

npx -y @heyditto/cli init --agent --agent-caller "hermes" --json

The skill lives at ditto-assistant/ditto-hermes. If you already manage your own key, heyditto login <key> still works instead.

Verify

npx -y @heyditto/cli status

If the status confirms authentication and lists the live tools, Hermes is connected and will use Ditto memory when the conversation calls for it.

Troubleshooting

Symptom	Fix
Skill installation fails	Confirm Hermes can reach GitHub and use the direct skill path `ditto-assistant/ditto-hermes/ditto`.
`error: no Ditto API key configured`	Re-run the init command above, then check `npx -y @heyditto/cli status`.
The claim link doesn’t work	Re-send the full `claimURL`, including everything after `?t=`.
Skill config needs a redo	Run `hermes skills config ditto` to re-open the skill’s config prompt.

Reference Links

After setup, add the memory workflow instruction to your persistent instructions. Keep claim links private; they authorize ownership of the agent account.