opencode-breadcrumb

OpenCode plugin that displays timestamp, session duration, and git context on each prompt.

Prerequisites

• OpenCode CLI
• Node.js >= 18
• Git (for git context features)

Example Output

🕐 01-14 18:30 (+2m15s) ⏱️1h23m * │ ⎇ main ↑2↓1 wt:feature(2) │ ✎3 +5 │ "Last commit msg" 2h

Format Reference

Time Section

Symbol	Example	Description
🕐	🕐 01-14 18:30	Current date (MM-DD) and time (HH:MM)
(+...)	(+2m15s)	Time elapsed since last prompt
⏱️	⏱️1h23m	Total session duration
*	*	30-minute checkpoint marker (appears every 30 min)

Git Section

Symbol	Example	Description
⎇	⎇ main	Current git branch
↑	↑2	Commits ahead of upstream
↓	↓1	Commits behind upstream
wt:	wt:feature(2)	Worktree name and total worktree count
✎	✎3	Number of modified files
+	+5	Number of untracked files
"..."	"Last commit msg" 2h	Last commit message (truncated) and age

Separators

Symbol	Description
│	Separates major sections
⊘	Shown when not in a git repository

First Prompt Defaults

On the first prompt of a session:

• Delta shows (+0s)
• Session shows ⏱️0s
• The * marker is skipped

Installation

npm install opencode-breadcrumb

Add to your ~/.config/opencode/opencode.json:

{
"plugin": ["opencode-breadcrumb"]
}

Then restart OpenCode.

Local Development

Clone the repo and link it locally:

git clone https://github.com/keybrdist/opencode-breadcrumb.git
cd opencode-breadcrumb
npm link

Then in your OpenCode config directory:

cd~/.config/opencode/node_modules
npm link opencode-breadcrumb

Or copy directly to node_modules:

cp -r opencode-breadcrumb ~/.config/opencode/node_modules/

Add to ~/.config/opencode/opencode.json:

{
"plugin": ["opencode-breadcrumb"]
}

Restart OpenCode to load the plugin.

State Files

State is stored in ~/.config/opencode/breadcrumb/:

File	Purpose
last_prompt_ts	Timestamp of last prompt (for delta calculation)
last_interval_ts	Timestamp of last 30-min marker
session_start_ts	Session start time

To reset session tracking:

rm -rf ~/.config/opencode/breadcrumb/

Troubleshooting

Plugin not loading?

• Ensure opencode-breadcrumb is listed in the plugin array in opencode.json
• Restart OpenCode after config changes

Git info not showing?

• Make sure you're in a git repository
• Shows ⊘ no git when not in a repo

Session timer keeps resetting?

• Session state persists across prompts but resets when OpenCode restarts
• State files are in ~/.config/opencode/breadcrumb/

License

MIT