diff --git a/.github/screenshots/agent.png b/.github/screenshots/agent.png new file mode 100644 index 0000000..54a79cf Binary files /dev/null and b/.github/screenshots/agent.png differ diff --git a/README.md b/README.md index d4fffc8..8e429e4 100644 --- a/README.md +++ b/README.md @@ -1,8 +1,19 @@ +
+ +Polypore + # Polypore -Agentic desktop IDE. Language agnostic, OS agnostic. Every surface is a dockable panel: split, reorder, close what you don't need. The built-in panels cover most workflows. If they don't, the SDK is there. +**An agentic desktop IDE that treats the agent as the primary actor, not a sidebar.** + +Language agnostic, OS agnostic. Every surface is a dockable panel you can split, reorder, or close. The built-in panels cover most workflows; when they don't, the SDK is there. + +[![License: MIT](https://img.shields.io/badge/License-MIT-orange.svg)](LICENSE) +[![Platform](https://img.shields.io/badge/platform-Linux%20%C2%B7%20macOS%20%C2%B7%20Windows-555.svg)](#install) +[![Built with Tauri](https://img.shields.io/badge/built%20with-Tauri%202-24C8DB.svg)](https://tauri.app) +[![No telemetry](https://img.shields.io/badge/telemetry-none-444.svg)](#) -> Tauri 2 · React 18 · Dockview · Monaco · MIT · no telemetry +
--- @@ -12,6 +23,33 @@ https://github.com/user-attachments/assets/a3961bf3-46cd-4168-8e12-9acfcb2bf6b7 --- +## Screenshots + + + + + + + + + + +
+ Editor panel +

Editor: Monaco with a live file tree and per-project diagnostics.

+ 		+ Debug and diff panels +

Debug: verify runs and checks on the left, the side-by-side diff and history feed docked on the right.

+
+ Memory panel +

Memory: a project knowledge base wired together with [[wikilinks]].

+ 		+ Agent panel +

Agent: the formation canvas, skills, MCP servers, and secrets in one place.

+
+ +--- + ## Install Download the build for your platform from the [latest release](https://github.com/evanklem/polypore/releases/latest). Polypore updates itself after the first install. @@ -33,17 +71,22 @@ To build from source instead, see [Getting started](#getting-started) below. --- -## The idea +## Why Polypore + +The agentic tooling space moves fast. The right models, CLIs, and orchestration patterns shift faster than a typical IDE ships releases, so Polypore is built to keep up instead of freezing a stack in place. This is not a code editor with an agent panel bolted on. The layout, the memory, the debug tooling, and the MCP server are all designed around the agent doing the work and a human steering it. -The agentic tooling space moves fast. The right models, CLIs, and orchestration patterns shift faster than a typical IDE's release cycle. Polypore is structured to keep up. Every surface is a sandboxed panel behind a shared contract. Any piece of the IDE can be swapped, extended, or dropped without touching the core. +Polypore is designed to be: -This is not a code editor with an agent panel added later. The layout, the memory system, the debug tooling, and the MCP server are all designed around the agent as the primary actor. +- **Agent-first:** every panel is wired into an MCP server, so an agent can drive the editor, debugger, and memory the same way you do. +- **Swappable:** each surface is a sandboxed panel behind one shared contract, so any piece can be extended, replaced, or dropped without touching the core. +- **Language and OS agnostic:** per-project config registries instead of a hardcoded toolchain, with builds for Linux, macOS, and Windows. +- **Yours:** secrets stay in the OS keyring, the model never sees plaintext, and there is no telemetry. --- ## Panels -Eight panels are available from the `+` tab button: +The built-in panels, all available from the `+` tab button: | Panel | What it does | |---|---| @@ -67,7 +110,7 @@ Third-party panels are sandboxed iframes using the same `HostRpcServer` contract ## polypore-ide MCP server -A Node MCP sidecar ships with Polypore. Claude Code picks it up from `.mcp.json` automatically. Gives agents direct IDE control through 22+ tools: +A Node MCP sidecar ships with Polypore. Claude Code picks it up from `.mcp.json` automatically. It gives agents direct IDE control through 22+ tools: | Namespace | What agents can do | |---|---| @@ -189,7 +232,7 @@ Contracts live in `schemas/` and codegen into `packages/sdk/src/types.gen.ts` an ## Contributing -See [CONTRIBUTING.md](CONTRIBUTING.md). +Issues and pull requests are welcome. See [CONTRIBUTING.md](CONTRIBUTING.md) to get started. ## License