Page 69 of 70
This page is one part of The Ishoo manual. The complete manual is a single page, short enough to read in one go: ishoo.app/docs/
Troubleshooting
If your agent can't see the Ishoo tools, restart it from the project folder. Then check that ~/.claude.json (Claude Code) or ~/.codex/config.toml (Codex) has an ishoo entry that runs ishoo mcp; Ishoo's setup screen adds it.
The agent can't see the Ishoo tools
Restart the agent from inside the project folder. Open the project in Ishoo and run the Agent screen of setup again if needed. If the project has its own .mcp.json, Claude Code may use it instead of your user settings; it needs an ishoo entry that runs ishoo mcp too.
The eye says Main is broken
Ask your agent: “What's broken on main, and can you fix it first?” Landing anything else on top is refused until it's fixed.
The store chip is amber
Ishoo couldn't reach the store's private home recently, so work landed elsewhere may be missing here. It keeps trying. The usual cause is a GitHub sign-in that has expired: run gh auth status.
Agent needed
This copy of the code has changes of its own and is missing updates. Ask your agent to combine them; it keeps your work and asks before discarding anything.
The agent made its own to-do file instead
Tell it: “Use the Ishoo tools for this project. If they aren't available, stop and tell me.”