# Guides

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

## Connecting

- [Connect an agent to one workspace](https://docs.mehen.dev/guides/connect-one-workspace.md): how do I install or update `mehen`, enrol this machine and register the agents?
- [Several workspaces on one machine](https://docs.mehen.dev/guides/several-workspaces.md): how does one machine serve a personal and a work workspace?
- [A second identity on the same machine](https://docs.mehen.dev/guides/second-identity.md): when and how do I give an agent its own `MEHEN_HOME`?
- [Register mehen with each agent](https://docs.mehen.dev/guides/harnesses.md): 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](https://docs.mehen.dev/guides/request-a-credential.md): how does an agent get a new key into the vault without seeing it?
- [Connect Gmail, GitHub or Microsoft](https://docs.mehen.dev/guides/oauth.md): how do OAuth connections work from the agent's side?
- [Find a credential and call an API](https://docs.mehen.dev/guides/call-an-api.md): how does an agent list, check and use a credential?
- [When a request needs approval](https://docs.mehen.dev/guides/approvals.md): what does an agent do with exit 3?
- [Project variables with mehen run](https://docs.mehen.dev/guides/projects.md): how do I give a coding project its variables without a `.env`?

## Running it

- [A CI runner or a shared machine](https://docs.mehen.dev/guides/ci.md): how do I enrol a machine a team owns, and what can it reach?
- [A machine or a key is compromised](https://docs.mehen.dev/guides/incident.md): what do I do, in what order?