# agegr/pi-web

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/agegr-pi-web).**

_How this analysis was created: the description and tags below were written by an AI model that read this project's README and public documentation pages; stars, license and language come straight from the GitHub API. The model does not read the source code._

8,089 stars · 1,215 forks · TypeScript · MIT

## Links

- GitHub: https://github.com/agegr/pi-web
- awesome-repositories: https://awesome-repositories.com/repository/agegr-pi-web.md

## Description

pi-web is a self-hosted web interface for running and reviewing sessions with an AI coding agent from the browser. Coding-agent sessions run on a server against local project folders and Git worktrees. Replies and tool calls stream into a chat window as they happen, and conversations can be branched, forked, or compacted as the work continues.

Sessions are organized by project and Git worktree. Checkouts of the same repository are grouped together, and each session remembers the directory it started in. Sessions can be resumed, renamed, pinned, archived, exported, and deleted. Past conversations can also be read from disk without starting an agent. A file explorer sits beside the chat, with previews for source code, Markdown, images, audio, PDF, and DOCX files, plus Git diffs so you can see what the agent changed. Interactive terminals can be opened in the chosen working directory.

Models can come from several providers, using subscription logins, API keys, or custom gateways. Providers, models, plugins, skills, and external tool servers are all configured from the browser. The interface is available in English, Simplified Chinese, and Traditional Chinese. It adapts to phones and tablets, installs as a progressive web app, and offers browser and sound notifications for agent activity.

The app is deployed as a Docker container with a Compose example, persistent volumes, bind-mounted project workspaces, and proxy support. A password is required, and hostname allow-lists, throttled sign-in attempts, and restricted file roots limit access. Non-loopback binding requires a long random password, and HTTPS is expected to come from a trusted reverse proxy or VPN.

## Tags

### Artificial Intelligence & ML

- [Web-Based Agent UIs](https://awesome-repositories.com/f/artificial-intelligence-ml/agent-deployment/web-based-agent-uis.md) — Provides a browser chat interface for running and reviewing AI coding agent sessions, with live streaming replies, tool calls and conversation branching.
- [Past Session Browsers](https://awesome-repositories.com/f/artificial-intelligence-ml/conversational-agent-sessions/past-session-browsers.md) — Lists past agent conversations grouped by project and reopens them to continue, with rename, export, delete, running state, context usage, and cost. ([source](https://github.com/agegr/pi-web#readme))
- [Model Provider Configurations](https://awesome-repositories.com/f/artificial-intelligence-ml/model-provider-configurations.md) — Lets users pick which model handles a conversation, manage enabled models, and sign in to providers with OAuth, API keys, or custom gateways. ([source](https://github.com/agegr/pi-web/tree/main/components))
- [Session Forking](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/agent-reasoning-engines/agent-context-management/session-forking.md) — Lets users copy a conversation's current branch into a new independent session so alternative directions can be explored without altering the original. ([source](https://github.com/agegr/pi-web/tree/main/demo))
- [Agent Change Reviews](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/integration-deployment/ai-agent-tooling/coding-agents/agent-change-reviews.md) — Shows changed files and per-file Git diffs for a working directory so users can inspect exactly what the agent edited. ([source](https://github.com/agegr/pi-web/blob/main/AGENTS.md))
- [Multi-Provider Chat Interfaces](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/model-integration-serving/model-integration-interfaces/ai-model-interfaces/llm-chat-interfaces/multi-provider-chat-interfaces.md) — Lets users pick models from several providers, using subscription logins, API keys or custom gateways, and shows how much context is used.
- [MCP Server Connections](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/model-integration-serving/model-integration-interfaces/model-context-protocol/mcp-server-management/mcp-server-connections.md) — Adds, enables, tests, and signs in to external tool servers per user or project, with trust checks before project-level servers run. ([source](https://github.com/agegr/pi-web/blob/main/AGENTS.md))
- [Conversation Branching](https://awesome-repositories.com/f/artificial-intelligence-ml/conversational-session-management/multi-session-context-synthesizers/session-history-retrieval/conversation-branching.md) — Branches a conversation into a new independent session file or an in-session branch to explore alternatives without losing the original thread. ([source](https://github.com/agegr/pi-web#readme))
- [Model Provider Settings](https://awesome-repositories.com/f/artificial-intelligence-ml/provider-connection-checks/model-provider-settings.md) — Provides a browser settings experience for adding providers, entering API keys, testing models, and managing plugin packages and skills. ([source](https://github.com/agegr/pi-web/blob/main/docs/README.zh-CN.md))
- [Configurable Engine and Tool Plugins](https://awesome-repositories.com/f/artificial-intelligence-ml/tool-integration-servers/configurable-engine-and-tool-plugins.md) — Adds, signs in to, and manages external tool servers and plugins that extend what the coding agent can do. ([source](https://github.com/agegr/pi-web/tree/main/components))

### Web Development

- [Browser Agent Chat Clients](https://awesome-repositories.com/f/web-development/browser-agent-chat-clients.md) — Provides a browser chat client for a coding agent, with live streamed replies and tool calls, plus branching and compaction of long conversations. ([source](https://github.com/agegr/pi-web/tree/main/components))
- [Server-Sent Event Streams](https://awesome-repositories.com/f/web-development/server-sent-event-streams.md) — Pushes agent output, tool calls, and progress to the browser over a long-lived connection so replies appear live.

### Business & Productivity Software

- [Project and Session Organization](https://awesome-repositories.com/f/business-productivity-software/project-and-session-organization.md) — Organizes past agent conversations by project and Git worktree so users can resume, fork, rename, pin, archive, and export sessions. ([source](https://github.com/agegr/pi-web/blob/main/AGENTS.md))
- [AI Agent Session Managers](https://awesome-repositories.com/f/business-productivity-software/team-collaboration-management/collaborative-chat-sessions/ai-agent-session-managers.md) — Lists, resumes, renames, exports, and deletes coding-agent conversations grouped by project, with running state, context usage, and cost shown. ([source](https://github.com/agegr/pi-web/blob/main/README.md))
- [Local Agent Session Managers](https://awesome-repositories.com/f/business-productivity-software/team-collaboration-management/collaborative-chat-sessions/ai-agent-session-managers/local-agent-session-managers.md) — Runs coding-agent sessions for user-selected project folders, keeping the web server's runtime separate from work inside each project. ([source](https://github.com/agegr/pi-web/blob/main/CONTEXT.md))

### Development Tools & Productivity

- [Worktree-Grouped Sessions](https://awesome-repositories.com/f/development-tools-productivity/git-worktree-management/worktree-grouped-sessions.md) — Groups sessions from the main checkout and linked worktrees under one project while each session remembers its starting directory.
- [Project File Previewers](https://awesome-repositories.com/f/development-tools-productivity/project-file-previewers.md) — Provides a file explorer beside the chat with previews for source, Markdown, images, audio, PDF, and DOCX, plus Git diffs of agent changes. ([source](https://github.com/agegr/pi-web#readme))
- [Agent Session Terminals and File Browsers](https://awesome-repositories.com/f/development-tools-productivity/agent-session-terminals-and-file-browsers.md) — Opens interactive terminals in the chosen working directory beside the chat, streaming input and output live with resize and kill controls. ([source](https://github.com/agegr/pi-web/blob/main/AGENTS.md))
- [Git Worktree Management](https://awesome-repositories.com/f/development-tools-productivity/git-worktree-management.md) — Lists every Git worktree for a project in a sidebar switcher and sets which checkout new sessions, the file explorer, and file mentions use. ([source](https://github.com/agegr/pi-web/blob/main/docs/worktrees.md))
- [Project File Explorers](https://awesome-repositories.com/f/development-tools-productivity/project-file-explorers.md) — Shows a project's files in an explorer beside the chat, renders documents like a README as previews, and displays Git diffs of agent edits. ([source](https://github.com/agegr/pi-web/tree/main/demo))
- [Project File Trees](https://awesome-repositories.com/f/development-tools-productivity/project-file-trees.md) — Shows a project's directory tree beside the chat and opens files in a viewer with previews for images, Markdown, diagrams, and tables. ([source](https://github.com/agegr/pi-web/tree/main/components))

### DevOps & Infrastructure

- [Self-Hosted Agent Servers](https://awesome-repositories.com/f/devops-infrastructure/self-hosted-server-platforms/self-hosted-agent-servers.md) — Runs coding-agent sessions on a server against local project folders and Git worktrees, deployable as a password-protected Docker container.
- [Container Deployment](https://awesome-repositories.com/f/devops-infrastructure/container-deployment.md) — Ships as a production Docker image with a Compose example, persistent volumes, bind-mounted workspaces, health checks, and environment-driven configuration.
- [Docker Container Deployments](https://awesome-repositories.com/f/devops-infrastructure/container-orchestration/container-runtimes/runtime-configuration-interfaces/docker-socket-orchestrators/docker-target-configurators/docker-container-deployments.md) — Ships a production Docker image with a shell and Git, a Compose example, and a mandatory password so the interface is never exposed unauthenticated. ([source](https://github.com/agegr/pi-web/blob/main/docs/docker.md))

### Part of an Awesome List

- [Agent Plugins and Extensions](https://awesome-repositories.com/f/awesome-lists/ai/agent-plugins-and-extensions.md) — Loads external tool servers, plugins, and extensions at runtime per user or project to add agent capabilities and interface widgets.

### Mobile Development

- [Mobile-Compatible Web Apps](https://awesome-repositories.com/f/mobile-development/mobile-compatible-web-apps.md) — Offers a responsive layout for phones and tablets and installs as a progressive web app, so it works like a native app.

### Security & Cryptography

- [Password Access Restrictions](https://awesome-repositories.com/f/security-cryptography/domain-access-restrictions/request-access-restrictions/password-access-restrictions.md) — Requires a password supplied through an environment variable before the interface can be used, and restricts which hostnames may reach it. ([source](https://github.com/agegr/pi-web/blob/main/docs/docker.md))

### User Interface & Experience

- [Mobile Web App Installers](https://awesome-repositories.com/f/user-interface-experience/mobile-interfaces/mobile-web-app-installers.md) — Registers a progressive web app and adapts the layout for small screens so the interface can be installed on a phone or tablet home screen. ([source](https://github.com/agegr/pi-web/tree/main/components))
- [Workspace File Previews and Editing](https://awesome-repositories.com/f/user-interface-experience/workspace-file-previews-and-editing.md) — Previews source code, Markdown, images, audio, PDF, and DOCX files, supports uploads, shows Git diffs, and refreshes automatically on change. ([source](https://github.com/agegr/pi-web/blob/main/docs/README.ja.md))