Repository navigation
[FEATURE]: session tags for organizing sessions across projects #50585
Description
Feature hasn't been suggested before.
- I have verified this feature I'm about to request hasn't been suggested before.
Describe the enhancement you want to request
Summary
OpenCode's session list only groups by Project (working directory). There's no way to organize sessions into user-defined categories that cut across projects. Requesting a native session tagging feature: one or more tags per session, with the sidebar/session list able to group or filter by tag. Since tags are many-to-many, a single session could belong to multiple groups at once.
Environment
- opencode version: 2.0.12
- OS: Darwin 25.6.0 (darwin arm64)
- Install/channel: latest
- Active plugins: none found in config
Motivating use case
Project (directory) is a useful grouping axis, but it's the only one. In practice, sessions relate to cross-cutting themes that don't map 1:1 to a repo — a theme can span multiple projects, and a project can contain sessions belonging to several unrelated themes. A flat per-project session list makes it hard to find related sessions once the list grows.
Checked and confirmed there's currently no way to do this:
- No
tag/label/groupfield exists onSession.Infoin the OpenAPI schema (only an untyped, unusedmetadataobject and an unusedsubpathstring). - No CLI/TUI setting in
cli.jsonexposes session tagging or custom grouping (checked the full CLI settings reference at opencode.ai/v2/docs/cli/config). - The session sidebar only lists Projects, with sessions flat underneath each one.
Requested behavior
- Allow assigning one or more free-form tags to a session, via UI and API/CLI (e.g.
opencode session tag <id> <tag>andopencode session untag <id> <tag>, or atags: string[]field onPATCH /api/session/{id}). - Because tags are many-to-many, let the same session appear under multiple tag groups simultaneously, independent of and alongside the existing Project grouping.
- Support filtering/grouping the session list by tag (e.g. a tag-based view in the sidebar, and a
--tagfilter foropencode session list). - Optional: support pinning specific sessions within a tag group.
Additional context
Related prior discussions (#21590, #30763, #9688) requested similar session organization concepts (statuses, flags, virtual folders) but were closed without a many-to-many tagging model landing. This request is specifically scoped to tags as the primitive, since a session can reasonably belong to more than one group at once.
Activity
github-actions commentedon Sep 22, 2026
This issue doesn't fully meet our contributing guidelines.
What needs to be fixed:
[FEATURE]:to match the Feature Request template (e.g.,[FEATURE]: session tags for organizing sessions across projects)Please edit this issue to address the above within 2 hours, or it will be automatically closed.
This issue might be a duplicate of existing issues. Please check:
If you believe this was flagged incorrectly, please let a maintainer know.
[-]feat: session tags for organizing sessions across projects[/-][+][FEATURE]: session tags for organizing sessions across projects[/+]github-actions commentedon Sep 22, 2026
Thanks for updating the issue! It now follows the contributing guidelines — the title has the
[FEATURE]:prefix and the verification checkbox is checked. We appreciate you taking the time to fix it.opencodejr commentedon Oct 28, 2026
Thanks for the detailed write-up, @rbrunan!
To restate the request: you'd like to give sessions one or more free-form tags (via the UI, the API and the CLI) and group or filter the session list by tag across projects, with one session able to show up under several tags. Maintainers will consider it.
Related earlier requests, all closed, that asked for similar ways to organize sessions but not many-to-many tags:
This can't really be built as a plugin today. Plugins can't change how the built-in session sidebar groups sessions, and sessions have no field for storing tags, so it would need support in OpenCode itself.
dedmen commentedon Nov 12, 2026
This is also a major annoyance for me with using OpenCode.
The GUI now has the native feature (Experimental options, organize vertical sidebar) to group by projects, but tbh that is worse than leaving it off.
The project grouping shows me inactive sessions I already closed and don't care about, it only shows 5 sessions and I need to click on Show more to get another 5 sessions.
My main work is in one project, with currently about 30 open sessions. Grouping by project is useless, and the existing grouping function only showing very few sessions, and sessions that I closed and don't want to see, is more harmful than useful.
Tags is exactly what I need, my open tasks can be categorized into a handful of tags. One of them having about 20 sessions in it that I'm currently slowly processing the results and then closing one-by-one.