Package Exports
- opencode-breadcrumb
- opencode-breadcrumb/package.json
Readme
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" 2hFormat 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-breadcrumbAdd 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 linkThen in your OpenCode config directory:
cd ~/.config/opencode/node_modules
npm link opencode-breadcrumbOr 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-breadcrumbis listed in thepluginarray inopencode.json - Restart OpenCode after config changes
Git info not showing?
- Make sure you're in a git repository
- Shows
⊘ no gitwhen 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