The setup, security, and affiliation details.
Short answers for what the Pokedex recipe does, what the local bridge can do, and where the boundaries are.
Is this a Pokémon thing? +
No. Pokedex is a developer tool for Poke and Codex. The name is a poke bowl joke, not a game or collection product.
Is Pokedex official? +
No. Pokedex is an independent, unofficial open-source project. It is not affiliated with, endorsed by, sponsored by, or maintained by OpenAI, Poke, The Interaction Company of California Inc., or Interaction.
Should I add the recipe or run the command first? +
Add the recipe first: Pokedex recipe for Poke. Then run the local bridge with npx codex-to-poke from the project folder you want Codex to see.
Does Poke get access to my computer? +
Poke gets MCP tools, not direct shell access. The local Pokedex agent checks the requested workspace alias and sandbox before it starts Codex.
Can Poke choose any project folder? +
No. Poke works with workspace aliases such as main or api. The real folders live in ~/.pokedex/config.jsonc on your machine. Advanced Codex skill inputs can include trusted local skill paths; treat those as privileged configuration.
What does read-only by default mean? +
On first run, Pokedex starts Codex with read_only access unless your saved config already allows writes. Codex can analyze, plan, and review, but it cannot write files in that mode.
How do write and full access work? +
workspace_write requires global write mode and allowWrite on the selected workspace. danger_full_access requires global full-access mode and allowFullAccess on the workspace.
How do approvals work? +
If Codex pauses for a command or file change, ask Poke to list approvals, then approve or decline the pending request with pokedex_approve or pokedex_decline. When only one approval is pending, no approvalId is needed.
Can I use Codex skills? +
Yes. pokedex_list_skills fetches local skills from Codex, including ~/.agents/skills and ~/.codex/skills. Pass skillNames or include $skillname in the prompt; Pokedex resolves the path and sends a skill input to Codex.
Do I need to open ports manually? +
No manual port forwarding is part of normal setup. Pokedex starts a local relay on 127.0.0.1 and runs the Poke tunnel command so your recipe can reach that MCP endpoint.
What does the relay see? +
The relay validates a bearer token and forwards MCP tool calls to the connected local agent. It does not work on files directly. Tool prompts and Codex outputs may contain project context you asked Codex to inspect, so treat them as project data.
Which MCP tools are supported? +
The current recipe exposes pokedex_setup_check, pokedex_list_workspaces, task and thread tools, review, goals, interrupt, approvals, skills, diff, and usage. The complete list is in the docs.
What platforms are supported? +
Pokedex supports macOS, Linux, and Windows on Node.js 20 or newer, plus a working local Codex install.
What commands are available in the terminal prompt? +
Type help inside the pokedex> prompt. Commands include status, config, output, workspace management, access toggles, model/reasoning/verbosity defaults, approval policy, port, token rotation, restart, and quit.
Is it open source? Under what license? +
Yes. Pokedex is MIT-licensed open source on GitHub. The repository contains the CLI, local agent, relay, protocol, security helpers, and Codex runner packages.