@oborchers/proqi

proqi

Terminal-native prompt composer for power users running multiple coding agents

Demo

Terminal preview

proqi

Overview

Terminal-native prompt composer for power users running multiple coding agents

A terminal-native prompt composer for power users running multiple coding agents.

From the maintainer

Origin story

I regularly work with several coding agents at once. I used to keep follow-up prompts, alternatives, screenshots, and pasted context in a separate text editor beside each agent session. That meant switching applications, losing the relationship between a prompt and its agent session, and occasionally leaving a half-written instruction in a live agent input field.

First workflow

Open Proqi in a pane beside a coding agent. Capture several follow-up instructions as separate thoughts, refine and reorder them while the agent continues working, then copy the next one or submit it to a verified adjacent agent through Herdr. Close and resume the board later without losing its contents or undo history.

Design choice

Proqi treats the terminal pane beside an agent as the design surface. It is a persistent, keyboard and mouse driven prompt board rather than another agent, editor, task manager, or terminal multiplexer. Thoughts remain independent and editable until they are deliberately transferred. The interface continuously reflows for narrow adjacent panes while preserving focus, cursor position, selections, and scroll state.

Roadmap

Continue improving the dependable local workflow: durable session recovery, responsive terminal interactions, and safe direct submission in verified Herdr environments. Proqi remains local-first, account-free, and usable through the clipboard everywhere.

Social 1 Social 2

Latest Release

Proqi v0.9.0

Released: Sep 9, 2026

Proqi 0.9.0

Proqi 0.9.0 makes keyboard control fully configurable, adds direct global agent
delivery, and strengthens capture, attachment, and terminal reliability.

Highlights

Use revised terminal-safe defaults that avoid commonly intercepted or
rewritten chords in the macOS, Ghostty, and Herdr delivery chain. Logical
Control now owns whole-thought and Board boundaries, macOS insertion uses
Control+N and Control+Shift+N, Edit cleanup uses Control+Shift+F, and
Browser Rename and Trash use F2 and F8. Portable defaults remain tailored
to the events delivered on Linux and Windows.
Configure every semantic keyboard action and fallback through one contextual
keymap instead of relying on Proqi's defaults. Multiple aliases, platform
overrides, and safe disabling flow through the same source as dispatch, Help,
footer controls, Commands, mouse targets, and diagnostics. Legacy keybindings
continue to translate at startup.
Find installed invocations with deterministic Unicode-aware fuzzy matching.
Exact, prefix, contiguous, and ordered-subsequence matches are ranked across
the complete bounded result set, while sigils retain their hard namespaces.
Choose Submit to agent... in Commands to send selected thoughts to an
eligible agent pane anywhere on the current Herdr server. Proqi revalidates
the exact target before delivery and preserves the source unless acceptance
and the requested disposition are durably recorded.
Use Paste and clean up spacing while pasting, or Clean up spacing on an
existing thought. Both preserve recognized Markdown, code, URLs, annotations,
Unicode, and large-paste envelopes, and every changed result remains undoable.
Track files and screenshots with independent session-wide File and Image
numbers that survive reordering, history, and restart. On macOS, authoritative
public metadata distinguishes an item that is in iCloud or downloading
without initiating a download.
Use terminal-safe logical controls for whole-thought boundaries, Board
boundaries, and insertion above or below. Editors now grow naturally at the
bottom of a full Board, expanded thoughts consume hidden rows before changing
focus, and new boundary thoughts preserve the selected Board density.
Resume input after a process-wide scheduling pause without a false terminal
failure. Screenshot Inbox pause explanations now clear after deliberate Board
activity while the underlying paused state remains visible.

Breaking changes

proqi --json diagnostics keypress now emits capture schema 1 with stable
status, context_source, event, and resolution fields. It no longer emits the
previous raw_event and matched_action shape.

Browser Rename and Trash now default to F2 and F8 while the query is empty.
Uppercase R and D remain ordinary Browser query text. All defaults remain
replaceable or disableable through keymap schema 1.

Compatibility

Existing stores migrate automatically from schema 12 and storage protocol 11
through schema 15 and storage protocol 14. The migrations add versioned global
delivery routes, durable session-wide attachment numbering, and Reflow history.
Older Proqi binaries cannot open an upgraded store.

Herdr protocols 19 through 21 are qualified. Protocol 22 is accepted
provisionally only when schema 1 and the required agent.prompt contract remain
compatible. Other protocol versions and mismatched live or schema declarations
are rejected before delivery.

The legacy [keybindings] table remains supported through explicit translation,
but it cannot be mixed with the new [keymap] table in one configuration.

Known limitations

A key consumed or remapped before reaching the PTY cannot be reconstructed by
Proqi. A keypress diagnostic timeout therefore reports only that no event was
received and does not attribute the responsible upstream layer.

Herdr protocols 19 through 22 do not provide an atomic user-turn boundary for
concurrent senders. Proqi preserves target verification, exact receipts, and its
no-resubmit contract without claiming that stronger upstream guarantee.

macOS iCloud labels depend on authoritative ubiquitous-item metadata. Generic
missing files, permission failures, and non-macOS platforms retain the ordinary
inaccessible status rather than being inferred as cloud state.

Discussions

0 comments

Loading comments...