Skip to content
Fungi
Esc
↑↓navigate↵open⌘Jpreview
On this page
Start here

Add Fungi to your AGENTS.md

A ready-to-paste AGENTS.md or CLAUDE.md section that tells a coding agent where Fungi's docs are, which commands to run and what not to guess.

Add Fungi to your AGENTS.md

A ready-to-paste AGENTS.md or CLAUDE.md section that tells a coding agent where Fungi's docs are, which commands to run and what not to guess.

Paste this section into your project’s AGENTS.md, CLAUDE.md or other agent instructions file. It tells Claude Code, Codex, Shiitake or another coding agent where to read about Fungi, how to set it up and what to check instead of guessing. Remove the lines for parts you don’t use.

## Fungi

- Read Fungi's docs for agents at https://docs.fungi.computer/llms.txt before
  answering questions about Fungi, Shiitake, Oyster or `fungi vm`. Every docs
  page is also Markdown: add `.md` to its path, for example
  https://docs.fungi.computer/install.md.
- To set something up, follow one recipe from
  https://docs.fungi.computer/agents/index.md. Run its commands exactly and
  compare the output with what it expects. Stop and ask the person at any
  sign-in, payment or key step.
- Shiitake (terminal agent): `npm i -g @fungi.computer/spore`, then `fungi` in
  the project folder. `fungi doctor` checks the platform and login.
- Use `fungi --workspace` or `fungi --read-only` for sandboxed commands. Never
  use `--yolo` (Full access) unless the person asks for it.
- Oyster: try it locally with `npx @fungi.computer/oyster try`. A deployed
  Oyster is reached over MCP at `<oyster-url>/mcp` with
  `Authorization: Bearer <key>`. Keep keys out of chat, logs and commits.
- Never quote Fungi prices, plans or limits from memory. Read
  https://docs.fungi.computer/account/billing.md and
  https://docs.fungi.computer/account/limits.md.

Connect Claude Code to an Oyster

If your project uses a deployed Oyster, add its MCP server once. Keep the key in a private environment variable, not in the instructions file:

claude mcp add --transport http oyster "$OYSTER_URL/mcp" \
  --header "Authorization: Bearer $OYSTER_AGENT_KEY"

Give Claude Code a cloud Linux sandbox explains how to issue that key and what it can reach.

Last updated on

Was this page helpful?