How do I find session ids for -s/--session?

Question

How do I find the session ids to use with opencode --session <session-id> to continue or resume a previous session?

$ opencode --help | grep -- --session
  -s, --session     session id to continue                              [string]

When I run the /sessions command, I see (non-unique) names and timestamps, but no ids
Maybe it'd be helpful to add an opencode sessions sub-command to the cli to list sessions with their ids, for the user to copy/paste into -s/--session

u can use opencode export or opencode run if u use run with the --format json flag. But youre correct we need that sessions list command

/oc Read cmd/ directory, introduce a new command called session, it should have a subcommand called "list" so youd call it like:
opencode session list

It should function kinda like how git log works where it paginates if possible and it should show session ids in a way or with flag in a way it could easily be used in a ci script if needed

Created PR #4558

opencode session | github run

Nice!

Another interim workaround: grep around under ~/.local/share/opencode/ to find the ses_* id. 🙃

~/.local/share/opencode $ rg 'clean up my alignment code'
storage/part/msg_a9e135a170018Ui4RfAZfIDlfl/prt_a9e135a17002vkzEexEqH2pup3.json
6:  "text": "clean up my alignment code in @src/ios/TasksView_i.swift "

~/.local/share/opencode $ cat storage/part/msg_a9e135a170018Ui4RfAZfIDlfl/prt_a9e135a17002vkzEexEqH2pup3.json
{
  "id": "prt_a9e135a17002vkzEexEqH2pup3",
  "sessionID": "ses_561eca5ebffeCngoybZWxbTrD8",
  "messageID": "msg_a9e135a170018Ui4RfAZfIDlfl",
  "type": "text",
  "text": "clean up my alignment code in @src/ios/TasksView_i.swift "
}

Another workaround is to use a very simple tool, like this:

$ cat .opencode/tool/get-current-session-id.ts 
import { tool } from "@opencode-ai/plugin"

export default tool({
  description: "Get the current session ID",
  args: {},
  async execute(args, context) {
    return context.sessionID
  },
})

Requires extra tool - Agent Sessions. I recently added OpenCode support. You can visually or via search find your sessions and then copy ID from a toolbar - will get something like - ses_533cded24ffeEg9nWRBZHMGN7c

jazzyalex.github.io/agent-sessions
native macOS app (signed and notarized)• open source

ses_533cded24ffeEg9nWRBZHMGN7c

Can we specify a session ID when starting opencode? But don't be like Claude Code which insists on using UUIDs — make it like tmux where you can specify any name you want.

@0xRango yes but you're gonna be unhappy because its not user friendly ids

@0xRango yes but you're gonna be unhappy because its not user friendly ids

Yes, so I wish I could define session id myself. Claude Code currently only supports adding -c to continue the last session — it's too difficult to resume other sessions.

we allow u to do -c and --session

for OP:

added session list command in next release: a8ad74a

we allow u to do -c and --session

for OP:

added session list command in next release: a8ad74a

Hi, I found that --session arg not support for custom session id, like --session-id of claude code. but the UUID s are very user-unfriendly. Can we use custom session id, like --session project1 to start new one or continue session?

Thanks! Confirmed opencode session list is now working in 1.0.129.

Navigation Menu

Repository navigation

How do I find session ids for -s/--session? #4557

Question

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

How do I find session ids for -s/--session? #4557

Description

Question

Activity

rekram1-node commented on Nov 20, 2025

rekram1-node commented on Nov 20, 2025

opencode-agent commented on Nov 20, 2025

jdanbrown commented on Nov 20, 2025

daniel-fahey commented on Nov 22, 2025

jazzyalex commented on Nov 29, 2025

chenyuejie commented on Nov 30, 2025

rekram1-node commented on Dec 3, 2025

chenyuejie commented on Dec 3, 2025

rekram1-node commented on Dec 3, 2025

chenyuejie commented on Dec 3, 2025

jdanbrown commented on Dec 3, 2025

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions