git404hub

what is opencode-mini-session fr?

karamanliev/opencode-mini-session — explained in plain English

Analysis updated 2026-05-18

13TypeScriptAudience · developerComplexity · 2/5Setup · moderate

tl;dr

OpenCode plugin that pops up a side chat with alt+b, carrying current session context, so quick questions do not clutter the main thread.

vibe map

mindmap
  root((opencode-mini-session))
    Inputs
      OpenCode session history
      User question
      Keybind alt+b
    Outputs
      Overlay reply
      Optional transcript injection
    Use Cases
      Side questions mid-task
      Try a different model briefly
      Read-only research without polluting main chat
    Tech Stack
      TypeScript
      OpenCode TUI
      Plugin API

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Ask a side question without breaking the main OpenCode thread

VIBE 2

Switch model just for a quick lookup using tab inside the overlay

VIBE 3

Inject a useful mini-session transcript back into the main chat

VIBE 4

Restrict the mini agent to read-only tools like grep, read, and webfetch

what's the stack?

TypeScriptOpenCodeNode

how it stacks up fr

karamanliev/opencode-mini-sessionandersondanieln/hexllamaantonlobanovskiy/agent-tmux-web
Stars131313
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderateeasymoderate
Complexity2/52/53/5
Audiencedevelopervibe coderdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires an existing OpenCode TUI installation and editing the config file under ~/.config/opencode to register the plugin.

in plain english

opencode-mini-session is a small plugin for OpenCode, an open-source terminal AI coding assistant. The plugin solves a specific workflow problem: you are deep in a long coding session with the AI, and a side question pops into your head that you do not want to clutter the main thread with. Pressing alt+b, or typing /mini in the command palette, pops up a small overlay window with a text input. You ask the side question there, get an answer, and the main conversation is left untouched. The overlay is not a fresh chat. The plugin first reads the current session's history, including user questions, assistant replies, and short summaries of any tool calls the AI ran. That text is then trimmed to fit a configurable token budget, by default 50000 tokens, and wrapped in a session-context block placed in the side conversation's system prompt. The result is that the mini session knows what was being discussed when you opened it, so a follow-up like why does that approach not work makes sense without having to re-explain. The mini session itself is a temporary isolated thread. Replies stream in as they arrive. You can ask several follow-up questions inside the popup. When you close it, the ephemeral session is deleted. There is also an option to inject the full mini-session transcript back into the main thread if you decide the side conversation was useful enough to keep. Several keys are bound inside the overlay: enter sends the question, alt+b hides the overlay so you can come back to it later, tab switches the model for the next question, and esc or ctrl+c cancels and closes. A command called /mini-model changes the model used for future mini sessions. The plugin is installed by adding an entry to the OpenCode TUI config file under ~/.config/opencode. Options include the model identifier, the token limit, the trigger keybind, and the list of tools the mini agent is allowed to call. The tool list defaults to read-only operations such as glob, grep, list, read, and webfetch.

prompts (copy fr)

prompt 1
Walk me through wiring this plugin into ~/.config/opencode and setting the model and token budget
prompt 2
Explain how the 50000 token context budget is built from session history in this plugin
prompt 3
Change the trigger keybind from alt+b to ctrl+space and rebuild
prompt 4
Add a command that pins the mini session to a specific model permanently
prompt 5
Show me where the tool allowlist is enforced inside the plugin code

Frequently asked questions

what is opencode-mini-session fr?

OpenCode plugin that pops up a side chat with alt+b, carrying current session context, so quick questions do not clutter the main thread.

What language is opencode-mini-session written in?

Mainly TypeScript. The stack also includes TypeScript, OpenCode, Node.

How hard is opencode-mini-session to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is opencode-mini-session for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.