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 standalone
gedpi repository 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.