Connect your agent

Hermes

Install the todo4 Hermes plugin, then connect your account by email OTP. Works with hermes chat and with gateway sessions (Telegram, WhatsApp). Takes about two minutes.

Requires Hermes Agent with Python 3.9+ and a working hermes CLI. See the Hermes plugin guide for context on how plugins plug in.

Step 1 — Install the plugin

Run these three commands in order. Step 2 matters: hermes plugins install does not run the plugin’s register() — only a chat session does. Without it the bundled skills never get copied into ~/.hermes/skills/.

Install the plugin into ~/.hermes/plugins/todo4/.

hermes plugins install https://github.com/panitw/todo4-hermes-plugin

2
Start a chat session so Hermes runs the plugin’s register() hook — this installs the bundled todo4-onboard and todo4-work skills into ~/.hermes/skills/. You can exit immediately.
hermes chat # then type /exit
3
Restart the gateway so Telegram/WhatsApp sessions pick up the new toolset. (Skip if you only use hermes chat locally.)
hermes gateway restart

Verify the install

```
hermes plugins list | grep todo4
```
Expected: enabled, v0.1.0, source=git
```
hermes skills list  | grep todo4
```
Expected: todo4-onboard + todo4-work, source=local
```
hermes tools list   | grep todo4
```
Expected: ✓ enabled todo4 Todo4

Step 2 — Onboard via email OTP

Hermes doesn’t auto-match fuzzy phrases to skills reliably. Use this explicit prompt to run the onboarding flow:

Paste this in chat

Run the todo4-onboard skill

1Start a Hermes chat session.
2Paste the prompt above into the chat.
3When asked, provide your email — todo4 sends a 6-digit verification code.
4Paste the code back into chat. The skill creates your account, connects this Hermes instance as your agent, and writes the MCP config automatically.
5Run `hermes gateway restart` (or `/reload-mcp`) so the todo4 MCP tools activate.

Fallback prompt if the skill doesn’t trigger: Use todo4_register to sign me up — my email is you@example.com

Test your connection

Back in Hermes, try one of these:

“List my todo4 tasks.”
“Create a task to review the Q2 report by Friday, p2.”
“Call todo4_status”— reports whether the agent token, MCP entry, and API reachability are all good.

Don’t have a todo4 account yet?

The onboarding skill creates one for you via email OTP. Or sign up first if you prefer.

Troubleshooting

Skills don’t show up after install

Make sure you ran hermes chat at least once after install. The register() hook only fires when a chat session starts — that’s when bundled skills get copied into ~/.hermes/skills/.

I never received the verification code

Check your spam folder. The skill rate-limits resends — if you hit the limit, wait a minute and ask the skill to send a new code.

MCP tools don’t appear after onboarding

Run hermes gateway restart (or /reload-mcp inside chat) so the new MCP server entry is picked up. Confirm with hermes tools list | grep todo4.

Updating the plugin

Hermes doesn’t currently pull plugin updates in place when the version in plugin.yaml hasn’t bumped. Uninstall + reinstall is the reliable path:

hermes plugins uninstall todo4
hermes plugins install https://github.com/panitw/todo4-hermes-plugin
hermes chat        # then /exit
hermes gateway restart