Skip to content

README.md

Latest commit

ย 

History

History
90 lines (63 loc) ยท 2.8 KB

README.md

File metadata and controls

90 lines (63 loc) ยท 2.8 KB

opencode-prompt-finder

A Node.js command-line tool that uses fzf to quickly search local opencode prompt history and print or copy the selected prompt.

English | ็ฎ€ไฝ“ไธญๆ–‡

โœจ Features

  • ๐Ÿ”Ž Fast prompt search with fzf
  • ๐Ÿ—‚๏ธ Multiple data sources: OpenCode SQLite DB, OpenCode history, or Codex history
  • ๐ŸŽฏ Agent filtering for top-level user prompts in DB mode
  • ๐Ÿ“‹ Flexible output: print to stdout or copy to clipboard

๐Ÿš€ Quick Start

Requirements

  • Node.js 18+
  • fzf
  • pbcopy for clipboard copy on macOS

Install dependencies:

npm install

Run directly:

node bin/opencode-prompt-finder.js

Or link it as a local command first:

npm link
opencode-prompt-finder

๐Ÿ“– Usage

opencode-prompt-finder [--source <auto|db|history|codex>] [--agents <list>] [--db-path <file>] [--path <file>] [--limit <n>] [--print]

Examples

Print a prompt selected from the most recent 100 entries:

node bin/opencode-prompt-finder.js --limit 100 --print

Use custom agent filters:

node bin/opencode-prompt-finder.js --source db --agents orchestrator,plan,build --print

โš™๏ธ Options

  • --source <auto|db|history|codex>: data source, default auto
    • auto: aggregate OpenCode + Codex prompts; OpenCode side prefers SQLite DB and falls back to OpenCode history
      • merged results are globally sorted by time (newest first), not grouped by source
      • if one side is missing/invalid/empty, it is skipped silently
      • only errors when both sides have no valid prompts
    • db: use SQLite DB only
    • history: use OpenCode history file only
    • codex: use Codex history file only
  • --agents <list>: only effective in SQLite DB mode; comma-separated top-level agents to keep. Default: orchestrator,plan,build
  • --db-path <file>: path to the OpenCode SQLite DB, default ~/.local/share/opencode/opencode.db
  • --path <file>: path to the OpenCode prompt history file, default ~/.local/state/opencode/prompt-history.jsonl
  • Codex history default path: ~/.codex/history.jsonl
  • --limit <n>: number of recent prompts to read, default 200
  • --print: print selected content to stdout instead of copying it to the clipboard

Sorting notes:

  • Display order is always newest first.
  • If timestamp is missing, entries are placed after timestamped ones and keep a deterministic recency fallback order.

๐Ÿ—„๏ธ SQLite Extraction Rules

  • Only extract messages where message.role = user and message.agent is included in --agents (default: orchestrator, plan, build), which helps exclude clearly internal delegated/subagent prompts
  • Concatenate text parts from each message in stable order
  • Keep text-related parts only; ignore image/file parts

๐Ÿ“„ License

MIT License