Extensible harness

Pi Agent

Minimal terminal harness designed to be extended, embedded, or automated.

Status
Active
License
MIT
Evidence
Documented + code-verifiable, 20 sources
Product record checked
2026-08-10

At a glance

An MIT-licensed terminal coding agent with a small core, broad provider and local-model support, JSON and RPC modes, and a TypeScript extension system for users who prefer to assemble their own workflow.

Good choice if

  • Developers who want a small terminal agent instead of a bundled platform
  • Custom workflows built with TypeScript extensions, RPC, or JSON events
  • Switching among subscriptions, API providers, and local endpoints

Check before choosing

  • There is no built-in permission system or OS sandbox: filesystem, process, and network tools run with the launching user's privileges, while project trust only gates project extensions and is not an execution boundary
  • Subagents, MCP, browser automation, file checkpoints, plan mode, and sandboxing are extension or external-container patterns rather than core capabilities
  • Session JSONL, resume, tree branching, and compaction recover conversation state but do not roll back files, processes, or external side effects
See 2 more considerations
  • The minimal core shifts safety, orchestration, and integration work to the user; third-party extensions execute code and must be audited separately
  • Project-owned behavioral and comparative eval assets are useful for development but are not an independent product benchmark and no score is imported

Capability support

Documented first-class product support, checked against the sources below.

External tools (MCP)
Not documentedNo first-class support established by the current recordAbsence of current documentation is not proof that the capability is impossible.
Reusable skills
DocumentedProduct-supported reusable skill packagesSource · checked 2026-08-05Support does not establish portability, package quality, safety, or adoption.
Local models
DocumentedLocal or self-hosted model pathSource · checked 2026-08-05The source establishes the mechanism, not its quality or availability in every mode.
Agent parallelism
Not documentedNo first-class support established by the current recordAbsence of current documentation is not proof that the capability is impossible.
Runs without an open UI
DocumentedNon-interactive or automation surfaceSource · checked 2026-08-05The source establishes the mechanism, not its quality or availability in every mode.
Browser control
Not documentedNo first-class support established by the current recordAbsence of current documentation is not proof that the capability is impossible.
Isolated execution
No built-in supportHost execution; external containerization is user-suppliedSource · checked 2026-08-05The official security guide documents no built-in permission prompts or sandbox.
Undo file changes
Not documentedNo first-class support established by the current recordAbsence of current documentation is not proof that the capability is impossible.

Getting started

Install `@earendil-works/pi-coding-agent`, connect a provider or local endpoint, then add only the extensions your workflow needs.

Open official documentation

Classification and operating model

Category fit and technical mechanisms are evidence records, not product-quality scores.

Category fit
Qualifies, 4/4 criteria
Operating model
7/7 layers documented
Inspect category criteria and operating mechanismsFirst-party records

Why it qualifies as a coding harness

This confirms category fit, not product quality. Every required criterion links back to first-party evidence.

Qualifies4 of 4 required criteria evidenced
  • Adaptive agent loop

    Documented

    The system repeatedly observes results and chooses the next action instead of following a fixed one-pass graph.

  • Repository tool execution

    Documented

    The system can use tools to inspect and change a repository or its execution environment.

  • Task-aware context management

    Documented

    The runtime assembles, updates, compacts, retrieves, or persists task-relevant context while work proceeds.

  • Model-independent runtime control

    Documented

    Permissions, budgets, interruption, policy, or stop controls operate outside the model's own text generation.

Membership establishes category fit only. It does not score quality, safety, autonomy, model capability, or benchmark performance. · Read the membership rule.

How it works under the hood

Seven mechanisms mapped from first-party records. These labels describe what the harness provides, not how intelligent its model is.

7/7layers documented
  • Execution & isolationHost processDocumented mechanism, not a performance score.
  • Tooling & integrationsBuilt-in toolsDocumented mechanism, not a performance score.
  • Context & stateManaged contextDocumented mechanism, not a performance score.
  • Lifecycle & recoverySession resumeDocumented mechanism, not a performance score.
  • ObservabilitySession onlyDocumented mechanism, not a performance score.
  • VerificationManualDocumented mechanism, not a performance score.
  • Governance & permissionsHost accessDocumented mechanism, not a performance score.

Measured and public context

Configuration-specific measurements and source-native activity stay separate from general product capability.

Inspect code audit, measured configurations, and ecosystem signalsContext, not a product score

Public code audit

5/5public artifacts present
Security policy
Present at inspected commit
CI workflow
Present at inspected commit
Automated tests
Present at inspected commit
Evaluation assets
Present at inspected commit
Contributor documentation
Present at inspected commit

The current tree contains 465 test-like paths, ten workflows, and a project-owned behavioral and comparative eval package. Its live-provider tasks and local run artifacts are valuable development evidence but do not supply an independent, immutable model × harness × environment × budget × attempts result, so no product score is imported.

Inspect commit 588915ec71714688cee8b7153339e8bdebb3e82e, checked 2026-08-05

Measured configurations

No benchmark run passes the full metadata admission policy for this harness yet. Missing data is not scored as zero.

Benchmark policy and all runs
Context, not quality

Public ecosystem signals

Source-native observations for exact mapped artifacts and reviewed stable release trains. Different units and populations stay separate, and missing coverage is never treated as zero.

View this harness in Usage
  • Latest stable releasev0.85.1Released 2026-09-05; 31 stable releases in 90 daysOpen release
  • OpenRouter 30d tokens6.11T#5 coding app; 2026-08-09 to 2026-09-07Open app page
  • Homebrew 30d events6.93KFormula: pi-coding-agentOpen artifact
  • npm last-month downloads8.95MPackage: @earendil-works/pi-coding-agentOpen artifact
  • Release asset downloads301.81K259 stable releases; 1340 matched assetsOpen artifact
  • GitHub stars102.95KFull-source repository; 12.86K forksOpen artifact

Routing, package retrievals, release downloads, editor installs, and repository interest observe different populations. They are never added together and never affect capability evidence, classification, or measured results.

Interpretation rulesSignals checked

First-party evidence

Each capability claim links to the first-party record that supports it.

20 first-party sourcesProduct record checked

Additional first-party sources

20 sources
View 19 more sources