Guides#

Which guide do I need?

Each guide answers one question, in the order you would meet it.

Connecting#

• Connect an agent to one workspace: how do I install or update mehen, enrol this machine and register the agents?
• Several workspaces on one machine: how does one machine serve a personal and a work workspace?
• A second identity on the same machine: when and how do I give an agent its own MEHEN_HOME?
• Register mehen with each agent: how do I add the MCP server and the skill to Claude Code, Codex, Cursor, pi, Gemini CLI, OpenCode, VS Code, Claude Desktop or any MCP client?

Using credentials#

• Ask a human for a credential: how does an agent get a new key into the vault without seeing it?
• Connect Gmail, GitHub or Microsoft: how do OAuth connections work from the agent's side?
• Find a credential and call an API: how does an agent list, check and use a credential?
• When a request needs approval: what does an agent do with exit 3?
• Project variables with mehen run: how do I give a coding project its variables without a .env?

Running it#

• A CI runner or a shared machine: how do I enrol a machine a team owns, and what can it reach?
• A machine or a key is compromised: what do I do, in what order?