Wiki / Start
PortCode wiki#
PortCode is a terminal agent that studies a program, rewrites it in Rust, and checks the result against the original. It is built for models you run yourself (Ollama, LM Studio, llama.cpp, vLLM, lakomoor.com/v1), and it also works with a hosted API or with your Claude Code or Codex subscription.
What sets it apart is the proof. PortCode pins the exact build of the original (sha256), writes down every fact as an observation, an inference or an unknown, ports one module at a time, and only calls a module done after a parity run passes against the original's own output.
Where to start#
| If you want to… | Read |
|---|---|
| install it | Install |
| pick a model and enter a key | First run |
| see what the screen shows and how to drive it | A tour of the app |
| port a program | The port workflow |
| look inside a binary, a Unity game or a .NET app | Clean-room and deep mode, Engines |
| use your Claude or ChatGPT subscription | Claude Code and Codex |
| run local models well | Providers and models |
| look something up | Slash commands, Keyboard shortcuts, Configuration, Command line |
The pieces#
- Agents decide what the model does:
buildfor general work,portfor the full port workflow,reversefor studying an original,planfor read-only planning, andteamfor several workers at once. See Agents. - Tools are everything the agent can do: read and edit files, run commands, record evidence, run parity checks, take screenshots, build the site. The app, the agent and
portcode toolshare one list. See Tools. - Modes decide how closely the original may be examined. The default, clean-room, only observes it from outside. Deep mode may disassemble, decompile and emulate it.
- Permissions keep you in charge: file edits and shell commands ask first unless you allow them. See Permissions.
- The ledger is the project's memory of facts about the original, kept in
.portcode/evidence/.
How these pages are organised#
Start gets you running. Use covers daily work in the app. Port and reverse explains the workflow that makes PortCode different. Models covers providers. Reference lists every command, key and setting. Project is for people who want to read or change the code.