Skip to content
VAC34 edited this page Jul 30, 2026 · 2 revisions

FastPrompter Wiki

FastPrompter — ultra-fast keyboard-driven scratchpad + prompt workbench for Windows. Python 3.11+, PyQt6. SQLite WAL persistence. Nuitka-built self-contained EXE.

Alt+X summons 100-slot scratchpad at cursor. Zero install, zero cloud, zero telemetry. All state syncs instantly to local DB.


Tech Docs Index

Core Architecture

  • Architecture Overview — system design, IPC single-instance, SQLite WAL, state sync, subsystems
  • Module Structuresrc/fastprompter/ tree, file responsibilities, core/ui/utils/watcher map
  • Core API & Classes — FastPrompterState, HotkeyManager, IPCServer, SoundManager, PomodoroEngine, UI widgets
  • Watcher Engine — CDP attach, Win32 hooks, queue injection, state machine, rate limits

Interface & Data

  • Configuration — DB schema (local_data_v15.db), settings keys, custom theme engine, backup mirrors
  • UI Components — layout diagram, panel breakdown (Editor, Silos, Queue, Files, Kanban, Table)
  • Keyboard Shortcuts — full reference: global, window, formatting, watcher, silo, snippet

Guides & Extensibility

  • User Guide — workflows, silo management, snippet macros, file containers, zen mode, Pomodoro timer, hide-markup, kanban/table
  • Troubleshooting & FAQ — crash logs (%TEMP%\fastprompter_crash.log), process cleanup, DB repair, hotkey conflicts
  • Plugin & Skill Dev — custom skills (skills.py), SAIPEN subagents, custom themes, cursor themes

Automation & Protocol

  • SAIPEN Protocol — v7 protocol spec: state machine loop, event logging, subSaipen read-only architecture, OUTBOX handoff
  • Deployment Guide — Nuitka compilation (tools/build.py), GitHub release (tools/release.py), one-click scripts

Project

  • Repo: vacterro/FastPrompter
  • Stack: Python 3.11+, PyQt6, SQLite WAL, Nuitka ≥4.1.2, pynput
  • License: MIT

Built with SAIPEN Protocol | GitHub

Clone this wiki locally