v1.1.30: Easier Permission Configuration, Todo Tool Returns
Release Date: January 21, 2026
One-Line Summary
This update makes permission path configuration more flexible and brings back the Todo List tool for OpenAI models, making task management smoother.
New Feature: Permission Paths Support ~
What was updated?
Now you can use ~ or $HOME to represent your user home directory when configuring permission whitelists.
Why is this needed?
Previously, you had to write the full absolute path (e.g., /Users/yourname/projects), which was cumbersome and configuration files couldn't be shared across different computers. Now you can write ~/projects, and it will automatically resolve to the current user's home directory on any computer.
How to use?
In your configuration file or startup parameters:
# Before (had to hardcode):
opencode --allow-read "/Users/alice/code"
# Now (more flexible):
opencode --allow-read "~/code"Feature Return: OpenAI Model's Todo Tool
What happened?
In previous versions, the Todo List tool for OpenAI models was temporarily missing. In this version, it's back!
What's it for?
The Todo List tool allows AI to create a task checklist when executing complex tasks, checking off items as they're completed. This is crucial for long or multi-step tasks, preventing the AI from "forgetting" or "going off track."
How to experience it?
When using OpenAI models (like GPT-4o) for complex tasks, you might see it proactively list a plan:
- [ ] Analyze code structure
- [ ] Modify configuration file
- [ ] Run tests
That's the Todo tool at work.
Desktop Improvements
- Terminal experience optimization: Fixed some terminal display and interaction issues.
- OAuth fix: More stable login to third-party services (like GitHub).
Should You Upgrade?
| Situation | Recommendation |
|---|---|
| Frequently configure path whitelists | ✅ Recommended upgrade |
| Use OpenAI models for complex tasks | ✅ Highly recommended |
| Other users | Optional upgrade |
Upgrade command:
opencode upgradeTechnical Details (Skippable)
Click to expand full update list
Core
- Add session list and session fork support to ACP (@remorses)
- Fix metadata matching to use model.id instead of model.api.id to support legacy model identifiers
- Adjust textVerbosity and reasoningEffort defaults to better align with Codex CLI behavior
- Implement home directory expansion for permission patterns using
~and$HOMEprefixes (@Danztee) - Add back todo list tools for OpenAI models
- Persist loaded model and mode when loading ACP sessions (@noamzbr)
- Update GitLab packages for better self-hosted instance support (@vglafirov)
- Make the models.dev domain configurable for offline environments (@bartbroere)
Desktop
- Rename favicon on web again
- Improve provider OAuth error handling in app
- Fix renaming non-git projects affecting other projects
- Tab should select suggestion in the app
- Fix type error
- Fix terminal issues and regressions
- Remove terminal button border to align with close button (@allanhvam)
- Fixed navigation issues when working with large sessions in desktop app (@dbpolito)