<h1>Proto desktop agent console</h1>
<p>Proto is a local-first Electron desktop app and CLI agent harness. Open a workspace, select a model, choose a permission mode, and give it a task. The runtime can call actions, read their results, and continue for up to 40 iterations.</p>
<h2>Runtime</h2>
<ul>
<li>Read-only actions may run in parallel; write actions run serially.</li>
<li>Cancellation stops the current run cleanly.</li>
<li>Sub-agents have separate context and a smaller iteration cap.</li>
<li>Background tasks and fan-out jobs handle bounded or repeated work.</li>
<li>Context compression keeps long sessions within the selected model’s limits.</li>
</ul>
<h2>Local data</h2>
<ul>
<li>Workspace instructions: <code>PROTO.md</code>, <code>AGENTS.md</code>, or <code>CLAUDE.md</code></li>
<li>Direct memory file: <code>.proto/MEMORY.md</code></li>
<li>Indexed memory: <code>.proto/memory/</code></li>
<li>Session records: <code>.proto/sessions/*.jsonl</code></li>
<li>Global Plugin config: <code>~/.proto/mcp.json</code></li>
<li>Workspace Plugin config: <code>&lt;workspace&gt;/.proto/mcp.json</code></li>
</ul>
<p>Files, credentials, memory, conversation history, and session records stay local. Hosted-model requests send the messages and selected context required for that request to the chosen provider. Plugin actions send requested data to the configured Plugin endpoint.</p>
<h2>Action families</h2>
<ul>
<li>Files: search, read, write, patch, multi-file edit, and undo</li>
<li>Development: shell, Git, GitHub, diagnostics, definitions, references, and hover</li>
<li>Web: search, page reading, in-app browser, and opt-in computer control</li>
<li>Work management: plans, tasks, goals, sub-agents, background tasks, and fan-out</li>
<li>Content: documents, slides, images, messages, and meetings</li>
<li>ERP.AI: apps, tables, columns, records, views, roles, workflows, reports, pages, documents, branches, previews, API keys, hosting, auth, and portals</li>
<li>Plugins: deferred external actions discovered when needed</li>
</ul>
<h2>Built-in skills</h2>
<p>The current desktop build includes 22 skill manifests:</p>
<ul>
<li><code>build-app</code>, <code>build-document</code>, <code>build-host</code>, <code>build-page</code>, <code>build-slides</code></li>
<li><code>build-workflow</code>, <code>test-workflow</code></li>
<li><code>coding</code>, <code>commit</code>, <code>review</code>, <code>pr-review</code>, <code>qa-page-ui</code></li>
<li><code>computer-use</code>, <code>deep-research</code>, <code>generate-image</code>, <code>fan-out</code></li>
<li><code>erpai-api</code>, <code>erpai-external-apps</code>, <code>erpai-records</code>, <code>import-data</code></li>
<li><code>manage-filters</code>, <code>manage-roles</code></li>
</ul>
<p>Install additional skills from a registry source, a GitHub repository, a URL, or a local folder.</p>
<h2>Permission modes</h2>
<table>
<thead>
<tr>
<th>Mode</th>
<th>Behaviour</th>
</tr>
</thead>
<tbody>
<tr>
<td>Ask</td>
<td>Pause before every action</td>
</tr>
<tr>
<td>Auto accept edits</td>
<td>Allow routine file edits; ask for higher-risk actions</td>
</tr>
<tr>
<td>Plan</td>
<td>Remove write actions from the action registry</td>
</tr>
<tr>
<td>Bypass</td>
<td>Skip approval prompts; use only in an isolated environment</td>
</tr>
</tbody>
</table>
<p>Dangerous command patterns still trigger checks. Root-level destructive patterns such as recursive deletion of <code>/</code> are hard-blocked.</p>
<h2>Plugins</h2>
<p>Plugins use Model Context Protocol internally. Proto supports local stdio and remote HTTP/SSE connections, OAuth, and environment-variable expansion. Action schemas are deferred and loaded through action search only when the task needs them.</p>
<h2>Models</h2>
<ul>
<li>Hosted routing: OpenRouter and Fireworks with your own key</li>
<li>Local providers: Ollama and LM Studio</li>
<li>Model families depend on provider availability and include Claude, Gemini, GLM, Minimax, Qwen, and Llama</li>
</ul>
<h2>Install</h2>
<ul>
<li>
<p>macOS: <a href="https://github.com/erphq/proto-releases/releases/latest/download/Proto-aarch64.dmg">https://github.com/erphq/proto-releases/releases/latest/download/Proto-aarch64.dmg</a></p>
</li>
<li>
<p>Windows: <a href="https://github.com/erphq/proto-releases/releases/latest/download/Proto-x64-setup.exe">https://github.com/erphq/proto-releases/releases/latest/download/Proto-x64-setup.exe</a></p>
</li>
<li>
<p>Linux: <a href="https://github.com/erphq/proto-releases/releases/latest/download/Proto-x86_64.AppImage">https://github.com/erphq/proto-releases/releases/latest/download/Proto-x86_64.AppImage</a></p>
</li>
</ul>
<p>Proto is proprietary and in v0 alpha. It is free during alpha; hosted-model usage is billed by the provider attached by the user.</p>
