Pimpo
Documentation

Roadmap#

What stands between Pimpo and being a serious alternative to OpenClaw and Hermes Agent, in the order we plan to build it. Written 2026-09-29.

Pimpo already does what they do not: tasks become tested routines that run without a language model, and every action passes rules, approvals, undo and a tamper-evident log outside the model. What it lacks is mostly distribution and ecosystem (nobody can install it yet, and there is little to install into it), and a few open-ended powers that people use those agents for every day: a browser, a shell, long tasks.

The order comes from scoring each item with Jev (TypeSafe) on user value, differentiation, how much its absence blocks adoption, build risk and safety risk (see the scores), then reviewing the result by hand. Where the order differs from the scores, the reason is written down.

Principles#

Milestones#

VersionThemeItems
M1v0.6Solid groundfix the known bugs · setup without Claude Code · real-account validation · first release
M2v0.7Easy to get and keepauto-update with rollback · official signing · Docker and VPS · packages · website and demo
M3v0.8An ecosystemgallery and protection list published, 50 routines · SKILL.md skills · proactivity
M4v0.9Handsagent-driven browser · code sandbox · learning the owner
M5v1.0Everywherestable formats · phone as part of the agent · voice conversation · parallel agents and long tasks · more channels
M6v1.1Each person their owna login per person · privacy between people, the owner included · passkeys and sessions
M7v1.2At a glancedashboards · routines as widgets · floating desktop widgets · Android and iOS home-screen widgets
M8v1.3Less frictionreplies answer their notice · conversation search · approvals bound to the operation · questions as cards · settings history · database integrity · private credential prompts · lasting progress
M9v1.4Where the family already isa Telegram dashboard · push triggers · who owns a memory · lessons to review · models and spending per person · live model catalog · outside password managers · one list of what needs you
M10v1.5A company of agentscompanies, roles and members · context and rules in layers · the org chart · members' routines and tasks · asking the boss · deciders, autonomy and decision levels · costs in layers · members' own accounts · coding in a worktree · product, finance and marketing · templates

Sizes: S is days, M one to two weeks, L several weeks. Items marked owner need something only the project owner can do (an account, a certificate, a decision).


M1 · Solid ground (v0.6)#

Goal: someone who is not the author installs Pimpo, sets it up in minutes with what they already have, and it keeps working on their real accounts.

1.1 Fix the bugs found while documenting · S#

Found while writing How routines work and Configuration:

Done when each has a test that failed before the fix, and the docs describe the fixed behavior.

1.2 Setup in minutes without Claude Code · M#

Today exploring and compiling assume Claude Code. A new user should get to their first routine with only an API key (any of the 12 providers) or a local Ollama, in under five minutes.

Done when five people who never used Pimpo reach a working routine without help, on macOS, Windows and Linux, with at least one of them on Ollama only.

1.3 Validate with real accounts · M (weeks of calendar time)#

The proof suite passes 20 of 20 on simulated data. Real mailboxes, calendars and sheets are messier.

Done when three weeks pass with no silent failure, every loud failure repaired or explained, and irreversible actions always approved.

1.4 First release · S · owner#

Done when curl … | sh, the .dmg, the .exe and the .deb each install and start on a clean machine.


M2 · Easy to get and keep (v0.7)#

Goal: installing, trusting and updating Pimpo is as easy as any mainstream app, on a laptop or a server.

2.1 Auto-update with rollback · M#

Done when an update from v0.7.0 to v0.7.1 happens without a manual download on all three systems, and a broken update rolls back.

2.2 Official signing · S · owner#

Done when the installers open without "unidentified developer" or SmartScreen warnings.

2.3 Docker and a server install · M#

Much of OpenClaw's and Hermes's use is on an always-on server.

Done when a new VPS runs Pimpo in under ten minutes following the guide, and the desktop app is paired with it.

2.4 Packages · S#

Homebrew (formula and cask), winget, Flathub and a Debian/RPM repository, updated by the release workflow.

Done when brew install pimpo, winget install Pimpo and flatpak install pimpo each install the latest release.

2.5 Website and demo · M · owner#

A site (owner: the domain) with what Pimpo does differently, a two-minute video of a request becoming a routine, the documentation, and the downloads per system. A comparison with OpenClaw and Hermes that is factual and dated.

Done when the site is live, linked from the README and the release notes.


M3 · An ecosystem (v0.8)#

Goal: a new user finds useful things to install on day one, and anyone can share what they built.

Done when 50 routines install from the app, and at least five came from people other than the maintainers.

3.2 SKILL.md skills · L#

OpenClaw's ClawHub and the agentskills.io format have thousands of skills. Pimpo can use them without inheriting their risk.

Done when the 50 most installed ClawHub skills that make sense for a personal agent install and work, each limited to what it declares, and the known-malicious ones are refused.

3.3 Proactivity · M#

The thing OpenClaw and Hermes users love most is an agent that starts the conversation.

Done when in real-account use (1.3) at least a third of the suggestions are accepted, and nobody turns it off for being noisy.


M4 · Hands (v0.9)#

Goal: the open-ended tasks people give to OpenClaw and Hermes (a site with no API, a script, a file to transform) work in Pimpo, safely.

These three items give the agent the broadest new powers on this roadmap. Jev rates their safety risk the highest of all (see the appendix). Each starts with an RFC and a threat-model update, and ships behind a Labs flag first.

4.1 Agent-driven browser · L · RFC#

Done when ten common tasks on sites without an API (booking, a utility's bill, a government portal, a shop order status) work in chat and as routines, with every submission approved.

4.2 Code sandbox · L · RFC#

Done when data tasks (convert a spreadsheet, analyze a CSV, resize photos, run a script from a skill) work end to end, and a red-team pass cannot reach a secret, the host or an unallowed domain from inside the sandbox.

4.3 Learning the owner · M#

Done when in blind comparisons the owner prefers answers with it over answers without it, and every learned preference can be traced to where it came from and removed.


M5 · Everywhere (v1.0)#

Goal: v1.0, with stable formats and Pimpo present wherever its owner is.

5.1 Stable formats for v1.0 · M#

The event log, routine, connector and backup formats are frozen as Releases and support promises: newer versions read older data, and every upgrade snapshots first. An LTS line starts.

5.2 The phone as part of the agent · L#

The phone app becomes a node: camera (a photo of a receipt or a document), location (routines that run when arriving somewhere), the phone's notifications and shortcuts, each a capability the owner grants on the phone, with the same rules and receipts.

Done when a routine can be triggered by arriving home and another by a photo of a bill.

5.3 Voice conversation · M#

A wake word on desktop and phone (on-device), and continuous spoken conversation using the local voices and Whisper already built in, with barge-in. Approvals are never given by voice alone for irreversible actions.

5.4 Parallel agents and long tasks · L#

A large job ("compare these 20 suppliers and prepare a proposal") is split across several agents that run in the background for hours, with a plan, progress in the app, a budget for the whole job, checkpoints that survive a restart, and a final report. Each agent has only the capabilities its part needs.

5.5 More channels · M each#


M6 · Each person their own (v1.1)#

Goal: several people share one Pimpo and nobody sees anyone else's things, not even the owner who runs it.

6.1 A login per person · M#

Every device and session belongs to one person and every request acts only for them. The owner pairs a phone for someone (a QR code that signs in as them); removing a person revokes their devices.

6.2 Privacy between people · L#

Every route has an access rule, and a route without one is the owner's. Routines, explorations, runs, conversations, memory, receipts, approvals, questions, recordings, jobs and the phone belong to their person; the owner administers the house (people, connections, models, rules, backups) but sees none of it. Members answer their own approvals; a lasting "always" is a house rule, so it stays the owner's. The live event stream gives others only an event's type.

Done when a test calls every route as a member with the owner's ids and as the owner with the member's, and nothing crosses.

6.3 Passkeys and sessions · M#

A passkey to sign in on a computer, sessions that expire and can be revoked one by one, and a limit on sign-in attempts.


M7 · At a glance (v1.2)#

Goal: any number of dashboards per person, any routine as a widget, and widgets outside the app, each on its own: floating on the Mac, Windows and Linux desktop, and on the home and lock screens of Android and iOS. The design is RFC 0003.


M8 · Less friction (v1.3)#

Goal: the small things people run into every day stop getting in the way. Most items are small and several come from what OpenClaw 2.0 and Codex shipped in 2026, adapted to Pimpo's rules.

8.1 A reply answers its notice · S#

Telegram and WhatsApp already put a notice's choices on buttons of that message. On Discord, Slack and Signal, which have no buttons, replying to a notice (the channel's own reply) with a number answers that notice, and only that one, however old it is and whatever arrived after it. A bare number keeps working for the latest notice as today. A reply to a notice already answered, expired or meant for someone else says so and does nothing.

Done when a reply to an older notice resolves it while a newer one waits, on every channel that has replies. Done.

8.2 Conversation search · S#

Search earlier conversations by words or an exact phrase, each person only in their own. Done.

8.3 Approvals bound to the operation · M#

"Approve for this routine" lets a routine repeat one action without asking again, as long as the action is the same: the same capability, recipients, hosts and amounts within the approved limit. Anything different asks again, and the owner sees and revokes these approvals in one place. It replaces most uses of a broad "always" rule. Done.

8.4 Questions as cards · M#

A routine's question offers its choices as buttons in the app and on every channel with buttons, and a typed answer is checked against them. Done.

8.5 Settings history · S#

Every change to rules, budgets, connections, models and people is recorded with who made it and when, secrets hidden, and can be undone. Done.

8.6 Database integrity · S#

Pimpo checks its database at start and before every snapshot. A damaged one is set aside, the last good snapshot is offered, and nothing is written over it. Done.

8.7 Private credential prompts · S#

When a routine or a connection needs a password or key, Pimpo asks for it in a form of its own that writes straight to the vault; it never passes through a chat, a channel, a model or the log. Done.

8.8 Lasting progress · S#

Long jobs and routine runs show progress that survives a reload and follows the person to the phone and the channels. Done.


M9 · Where the family already is (v1.4)#

Goal: Pimpo meets people in the apps they already use and learns without being told twice, without giving up any promise of M6.

9.1 A Telegram dashboard · M#

A Telegram Mini App with the person's approvals, routines, spending, questions and their M7 widgets, signed in as that person. Done.

9.2 Push triggers · M#

Gmail (through Google's push notifications), Slack and GitHub start routines as events happen, instead of Pimpo checking every few minutes. The events reach routines as data, like everything read from outside. Done.

9.3 Who owns a memory · S#

Each fact shows where it came from (a conversation, an email, a routine), and a person can delete everything derived from one source. Done.

9.4 Lessons to review · M#

When Pimpo notices something worth keeping (a preference, a routine it could compile, a fix that worked), it proposes it as a lesson; the person accepts, edits or rejects each one in one place. Nothing becomes a rule or a routine without that. Done.

9.5 Models and spending per person · S#

The owner chooses which models each person and each assistant may use, and a daily limit per person inside the house's. Done.

9.6 A live model catalog · S#

The list of models comes from the providers themselves, with prices, and long conversations with Anthropic use its server-side context compaction. Done.

9.7 Outside password managers · M#

Secrets can live in 1Password or HashiCorp Vault; Pimpo keeps only a reference and reads the value when a connector needs it. Done.

9.8 One list of what needs you · S#

Approvals, questions and failed routines in one list, newest and most urgent first, on the app and the phone. Done.

To study before planning#

Each would need an RFC first:

M10 · A company of agents (v1.5)#

Goal: a person creates a company of any kind, hires agents into roles of their own with their own accounts, routines and budget, and sees it work: who does what, who waits for whom, what it costs. The highest decisions always reach the CEO, who is a person. The design is RFC 0004.

It is built in waves, each usable in Labs before the next: the engine and the engineering path, then product, project and finance, then marketing. The pilot (10.12) measures the most expensive bet, agents delivering code that is accepted at a reasonable cost, as soon as the first wave exists.

Done when the "Pimpo Dev" company runs for 30 days with every department: at least 20 issues born from the product owner's briefs closed by accepted pull requests, 2 tutorials and 12 shorts published, a monthly finance report that matches the invoices, within budget every day, no action outside a member's matrix, no strategic decision taken by anyone but the CEO, and no silent failure.


Where the order differs from the scores#

How progress is tracked#

Each item becomes an issue with the roadmap label and its milestone; Status records what is done and what waits on people or time; the CHANGELOG records what shipped. This roadmap is reviewed at the end of each milestone.

Appendix: scores#

Jev (tools/jev/decisions_roadmap.py, 2026-09-29), each from 0 to 3. Total is 2 × value + differentiation + 2 × adoption − build risk − safety risk.

ItemTotalValueDifferentiationBlocks adoptionBuild riskSafety risk
Real-account validation (1.3)7.892.831.102.161.931.26
Known bugs (1.1)7.712.271.151.871.140.58
Setup without Claude Code (1.2)7.421.871.542.351.461.10
First release (1.4)7.051.820.722.271.120.73
Official signing (2.2)5.101.031.901.441.110.63
Auto-update (2.1)4.751.292.521.281.201.71
Proactivity (3.3)4.702.111.011.321.721.45
Website and packages (2.4, 2.5)4.410.761.101.741.110.58
Gallery and protection list (3.1)4.381.581.561.181.381.32
Learning the owner (4.3)3.831.781.321.001.681.37
SKILL.md skills (3.2)3.501.591.671.251.921.93
Docker and VPS (2.3)3.351.271.001.471.461.67
Code sandbox (4.2)2.871.601.081.531.782.69
Browser (4.1)2.681.910.911.401.992.86
Phone as a node (5.2)1.321.160.920.971.802.06
More channels (5.5)1.091.370.211.391.892.75
Parallel agents (5.4)0.510.901.040.751.901.93
Voice conversation (5.3)0.290.900.810.631.871.71

This page is built from the repository's documentation. Improve it on GitHub.