Proqi user guides¶
Applies to Proqi 0.14.0. Earlier additions are identified by version where the distinction matters.
Proqi is a local, resumable prompt board. Each thought stays editable. Copying never changes it, and Submit and keep retains it. For direct agent delivery, an accepted Submit removes the local source, and that removal is undoable. Start with the workflow you need:
| I want to... | Guide |
|---|---|
| Create and edit exact prompt text | Capture and edit thoughts |
| Work with one thought or a group | Select and act on thoughts |
| Split, extract, merge, reorder, or separate thoughts | Transform and organize thoughts |
| Make shortcuts reach Proqi reliably | Configure and troubleshoot shortcuts |
| Paste readable text or attach local files | Paste, clean up, and attach files |
| Turn new macOS screenshots into thoughts | Use Screenshot Inbox |
| Find Proqi actions, skills, commands, or collaborators | Discover commands, skills, and collaborators |
| Send a prompt to a verified coding agent | Deliver prompts to agents |
| Open Proqi beside a Herdr agent with one key | Use Proqi as a Herdr plugin |
| Name, separate, resume, or recover work | Organize sessions and recover work |
| Check for updates or restart safely | Update Proqi and active sessions |
| Change themes, list behavior, density, or mouse capture | Configure appearance and behavior |
The three things to know first¶
- Focus and selection are different. Focus identifies the item that navigation and single-item actions address. Selection builds a group for bulk actions. See Select and act on thoughts.
- Copying and delivery are different. Unannotated copying uses the native clipboard when available and a bounded terminal fallback where supported; annotated copy and cut require macOS typed clipboard support. Direct delivery is available only through a verified Herdr integration. See Deliver prompts to agents.
- There is no save command. Proqi saves accepted changes automatically and shows durability in the footer. A storage failure keeps the in-memory work visible and offers explicit retry or recovery export choices. See Organize sessions and recover work.
Find actions without memorizing keys¶
Press : in Board mode to open Commands. Search for an action by name, then
press Enter or click it. Commands uses the same availability rules as the
keyboard and mouse controls, so an unavailable action is not presented as if it
could run.
Press ? for contextual Help. Help and the footer show the effective bindings
after configuration, not merely the factory defaults.
For exhaustive discovery, use the complete feature index, the Commands reference, and the CLI reference. For local history behavior, see Undo and redo.
Versioning¶
The human CLI, configuration, and machine JSON may change between Proqi minor releases before 1.0. Use the guides that match the installed version shown by:
Release-specific changes belong in GitHub Releases. These guides intentionally cover user workflows, not internal architecture or handoff contracts.