opcode-kit

Small Unix-style helpers for OpenCode workflows, as a single Go binary.

   ██████╗  ██████╗   ██████╗  ██████╗  ██████╗  ███████╗          ██╗  ██╗ ██╗ ████████╗
  ██╔═══██╗ ██╔══██╗ ██╔════╝ ██╔═══██╗ ██╔══██╗ ██╔════╝          ██║ ██╔╝ ██║ ╚══██╔══╝
  ██║   ██║ ██████╔╝ ██║      ██║   ██║ ██║  ██║ █████╗            █████╔╝  ██║    ██║   
  ██║   ██║ ██╔═══╝  ██║      ██║   ██║ ██║  ██║ ██╔══╝            ██╔═██╗  ██║    ██║   
  ╚██████╔╝ ██║      ╚██████╗ ╚██████╔╝ ██████╔╝ ███████╗          ██║  ██╗ ██║    ██║   
   ╚═════╝  ╚═╝       ╚═════╝  ╚═════╝  ╚═════╝  ╚══════╝          ╚═╝  ╚═╝ ╚═╝    ╚═╝   

Commands

opcode-kit switch   manage local OpenCode accounts
opcode-kit last     find and reopen OpenCode sessions
opcode-kit version  show version
opcode-kit help     show usage

Legacy compatibility wrappers (installed alongside):

• opcode-switch → opcode-kit switch "$@"
• opcode-last → opcode-kit last "$@"

Install

curl -fsSL https://raw.githubusercontent.com/srmdn/opcode-kit/main/install.sh | bash

This builds the binary from source and installs it plus both wrappers into ~/.local/bin (or $PREFIX/bin).

Selective installs:

curl -fsSL https://raw.githubusercontent.com/srmdn/opcode-kit/main/install.sh | bash -s -- opcode-kit
curl -fsSL https://raw.githubusercontent.com/srmdn/opcode-kit/main/install.sh | bash -s -- opcode-switch
curl -fsSL https://raw.githubusercontent.com/srmdn/opcode-kit/main/install.sh | bash -s -- opcode-last

From a local checkout:

./install.sh

Requires:

• go (to build)
• OpenCode

Tool-specific notes:

• opcode-kit last reads the local SQLite history, no network
• opcode-kit switch --verify needs opencode on PATH

Quick Start

Session recovery:

opcode-kit last
opcode-kit last --show 1
opcode-kit last --open 1
opcode-kit last --recent

Account switching:

opcode-kit switch
opcode-kit switch --save personal
opcode-kit switch work
opcode-kit switch --remove old-account
opcode-kit switch --verify

--remove deletes the saved account and its matching OpenCode Go store entries while preserving other providers.

Example Output

$ opcode-kit last
OpenCode sessions for:
  /path/to/project

[1] Fix installer edge case
     id: ses_abc123
     dir: /path/to/project
     updated: 2026-06-23 19:41:02
     messages: 38
     first user: make install.sh support one-tool installs too
     last user: sanitize repo before first commit
     last assistant: no confidential data found in tracked files...

Next:
  opcode-kit last --show N
  opcode-kit last --open N

$ opcode-kit switch
Available accounts:
  → personal
    work

Usage: opcode-kit switch <name>

Why This Exists

OpenCode keeps local session history, but finding the right session later is not always easy.

Common failure modes:

• a session still exists, but the user cannot remember which one has the useful context
• switching API accounts used to mean hand-editing auth files, and older tooling wrote a file OpenCode stopped reading

opcode-kit fixes both with small, inspectable commands.

Development

go build ./...
go vet ./...
go test ./...

The only external dependency is modernc.org/sqlite (pure-Go, no cgo) for reading session history.

Repo Shape

opcode-kit/
  README.md
  LICENSE
  AGENTS.md
  install.sh
  cmd/
    opcode-kit/
      main.go
  internal/
    switchcmd/
    last/
  docs/
    opcode-switch.md
    oc-last.md

Principles

• keep tools small
• keep tools readable
• prefer Go stdlib, one dependency max
• solve real OpenCode workflow problems

Docs

• docs/opcode-switch.md
• docs/oc-last.md

License

MIT