Overview
Most AI coding agents start every session from scratch. They forget your project's constraints, skip clarification, and jump straight into editing files. Ged fixes that with a structured workflow and durable memory layer that sits on top of your existing editor.
The agent clarifies your intent before touching code, writes a
spec and task list, implements in bounded slices, and verifies
each slice before moving on. Everything it learns about your
project (architecture decisions, standards, glossary) persists
in a .ged/ directory as human-readable markdown.
GedPi brings that workflow to the
Pi
editor as a single, always-on package. Drop it into any project
and the agent starts clarifying, planning, and implementing in
bounded slices out of the box. It lives in the
ged-mono repo and ships on npm.
The Workflow
Ask one focused question at a time until behavior, constraints, non-goals, and success criteria are concrete.
Write a real spec, task list, and test plan in
.ged/. No edits until these exist.
Work bounded task slices with test-driven discipline. One slice at a time, verified before moving on.
Run planned checks, clean-context review the diff, then update state so the next session picks up cleanly.
Features
The full Ged workflow is always active. GedPi classifies each task as trivial or non-trivial and adjusts on its own, so simple edits stay quick while larger work gets clarified, planned, and verified.
- Repo map incrementally indexes source files, ranks them by structure and recent activity, and injects a compact codebase-awareness block into prompts
- Skill discovery finds and installs relevant skills automatically, and creates project-local skills when none exist
- Bundled extensions add web search, native micro-UI via Glimpse, native git diff review, prompt-template workflow commands, and theme support
- Subagent orchestration delegates to read-only explorer, planner, and verifier roles while the main brain stays the sole writer
- Durable memory keeps standards, decisions, specs, tasks, and session state in a
.ged/directory as human-readable markdown - Auto-updater checks for new versions on startup and prompts to install and restart
npm install -g gedpi
# run in any project
cd your-project && gedpi
Durable Memory
GedPi uses a three-tier memory architecture
under .ged/. All memory is project-scoped and
stored as human-readable markdown you can edit, review, and
commit alongside your code.