# pm7Code

> pm7Code is an ACE — an Agentic Coding Environment. A macOS workspace where your projects live, your coding agent works, and your apps get built and shipped. You bring your own agent (Claude Code, OpenAI Codex, Pi, ...); pm7Code is the workspace around them.

## What pm7Code is

- **Category:** ACE (Agentic Coding Environment) — the workspace you live in while a coding agent does the typing.
- **Platform:** macOS desktop app, built on Electron + React 19 + TypeScript + Zustand, with node-pty for PTY process management and xterm.js for terminal rendering.
- **Agents supported as interchangeable runtimes:** Anthropic Claude Code CLI, OpenAI Codex CLI, Pi (multi-provider, defaults to Google Gemini). New agents can be added without changing the workspace around them.
- **Author:** PM7 (https://pm7.dev). Currently private / closed-source.

## Positioning

- pm7Code is **not an IDE**, not a code editor, not a model wrapper, and not a hosted service.
- It runs locally on macOS and spawns the agent CLIs you already have installed.
- It is **agent-agnostic by design**: no lock-in to one model or provider.
- The underlying promise is **efficiency** — fewer context switches between terminal, editor, browser, and agent UI, so the developer ships faster.

## Core concepts (terminology used inside pm7Code)

- **TView** — Terminal View. The xterm.js terminal pane.
- **CView** — Claude View / agent transcript. Readable history of every agent run: prompts, tool calls, results, summaries, status — searchable and replayable per session.
- **CC** — Command Center. The input panel below the terminal where you compose prompts, store reusable "shelves" (numbered 1–9 for quick recall), and access per-project history.
- **BView** — Browser View. Optional webview panel right of CView, with its own tab system (build 2.0.468+).
- **Session** — One conversation / run of an agent inside a project. Has its own transcript, prompts, and history. Sessions can be started fresh ("Start new session here") or continued.
- **Project** — Top-level unit of work. A workspace folder on disk. Sessions live inside projects.

## What pm7Code is for

- Developers who use one or more coding agents and want **one workspace** to drive them from instead of jumping between native provider apps.
- Running the **full dev cycle in one place**: open projects → talk to your agent → run builds → ship deploys — without context-switching.
- **Bring-your-own-agent** workflows where you want to compare or combine Claude, Codex, and Pi on the same project.

## What pm7Code is not for

- Not for users looking for autocomplete or in-editor inline AI suggestions (use Cursor, Copilot, etc).
- Not for users on Windows or Linux (currently macOS-only).
- Not for users who want the agent abstracted away — pm7Code surfaces the agent's transcript and tool calls deliberately, so the developer stays in the loop.

## Key features

- **Bring your own agent** — Claude, Codex, Pi as interchangeable runtimes; switch or combine without leaving the workspace.
- **Projects at the center** — work is organized by project, not by which agent thread ran last.
- **Build & deploy in place** — run builds and deploys from the same workspace where you prompt the agent.
- **Command Center** — prompts, shelves (numbered snippets), per-project history.
- **CView transcript** — full readable history of every agent run.
- **One workspace, zero context-switching** — terminal, agent transcript, project state, builds, deploys all visible at once.
- **Local-only** — no telemetry to PM7, no cloud sync; the agent's own CLI handles its own backend.

## Key URLs

- Website: https://code.pm7.dev
- Documentation: https://code.pm7.dev/docs
- Author / publisher: https://pm7.dev
- Version metadata (machine-readable): https://code.pm7.dev/version.json

## Naming and tone

- The product name is **pm7Code** (lowercase `pm7`, no separator, capital `C`).
- The category abbreviation is **ACE**, which expands to **Agentic Coding Environment**.
- "Workspace" is the preferred word in body copy; "Environment" is reserved for the ACE expansion.

## Optional

- pm7Code references three open-source projects as internal sources of truth: OpenAI's Codex CLI, Anthropic's Claude Code CLI, and the t3code web-based agent GUI. Integration behavior (status detection, session management, hooks, PTY input handling) follows those upstreams.
- Build versions are tracked in `/version.json` and shown inside the app for support purposes.
- The website (this site) is a Next.js 16 + React 19 + Tailwind 4 project, deployed on Vercel.