v1.2.4: New Database Check Command, Desktop Bug Fixes
Release Date: February 15, 2026
One-Sentence Summary
This update adds a database check command for easier troubleshooting, and fixes some desktop bugs.
New Feature: Database Check Command
What was updated?
Added the opencode db command, allowing direct querying and inspection of OpenCode's SQLite database.
What is opencode db?
This is a developer tool that lets you directly view content stored in the database, such as OpenCode session data and file records.
When to use it?
You can use it to troubleshoot the following issues:
| Issue | Usage |
|---|---|
| Can't find session | opencode db "SELECT * FROM sessions" |
| Abnormal file records | opencode db "SELECT * FROM files" |
| Want to see database structure | opencode db ".schema" |
Note: Regular users generally don't need this command; only use it when encountering data issues.
New Feature: JSON Migration Improvement
What was updated?
When migrating from JSON format to SQLite database, all IDs are now derived from file paths to ensure consistency.
What are the benefits?
Ensures IDs remain consistent after data migration, avoiding data association errors.
Bug Fix: Desktop File Tree Crash
The Previous Problem
In the desktop application, opening the file tree in certain situations could cause the program to crash.
The Current Situation
This stack overflow issue has been fixed, and the file tree can now be used normally.
Bug Fix: Notification Clearing
The Previous Problem
Desktop application notifications kept piling up and couldn't be cleared.
The Current Situation
Added a "Clear Notifications" action, allowing manual clearing of the notification list.
Should You Upgrade?
| Situation | Recommendation |
|---|---|
| Encountered file tree crash on desktop | ✅ Upgrade |
| Want to troubleshoot database issues | ✅ Upgrade |
| Everything works fine | Can wait for next release |
Upgrade command:
opencode upgradeTechnical Details (Optional)
Click to expand full changelog
Core
- Added db command for database inspection and querying
- Derive all IDs from file paths during JSON migration
Desktop
- Clear notifications action
- Fixed stack overflow issue in file tree component