The Claude Code sessions you started in a terminal, IDE, or the desktop app: what is running, what is waiting on you, and what just finished, by project. The execution agent can read a session, continue one that is not open elsewhere, or start one in a folder you allow.
by Sidebud · Version 1.0.1
Add it from the app
Say or type “add Claude Code sessions” in Sidebud. Your computer installs the widget, starts it switched off, and walks you through setup.
The Claude Code sessions you started in a terminal, IDE, or the desktop app: what is running, what is waiting on you, and what just finished, by project. The execution agent can read a session, continue one that is not open elsewhere, or start one in a folder you allow.
Tested by SidebudChecked on macOS against Claude Code 2.1.282: sessions listed from real files with live state, a headless session started in a temporary folder and continued. Not yet checked on the phone or on Windows.
On your phone
Made-up sample data, as your phone would show it. Tap the tile to open it.
9:41▂▄▆ ◠ ▭
Sidebud
Think. Speak. Get it done.
▭ Your computer
Tap Start chat to talk
🎙 Start chat💬 Messages
Details
Publisher
Sidebud
Connects to
Claude Code's session files and the claude command on this computer, through the server in this pack
You choose
Claude Code on this computer
Category
Agents
Widget ID
app.sidebud.claude-code-sessions
Made by Sidebud
The Sidebud team builds and maintains this widget and checks it before it is listed.
Every widget runs on your own computer with the access listed below. Installing starts it switched off; you choose when to turn it on, and your agent walks you through setup.
What it can do on your computer
3 tools read and 3 tools change things. Your computer only ever calls the tools listed here, and you can turn off any of them on the widget’s page after installing.
What it can control
Full control of your computer
Can control your whole computer. It starts agents or runs commands that can do anything you can there: open, change, and delete your files, use your apps and signed-in accounts, and install software.
Can change things with 3 tools, and reads with 3 tools.
Runs its own program on your computer as you while it is on. Sidebud decides which of its tools are called, not what that program itself can reach.
Tool
Access
Used by
list_sessions
Recent sessions and which are running or waiting
Reads
widget data (sessions)
list_projects
Folders Claude Code has worked in
Reads
widget data (projects)
read_session
A session's latest messages, trimmed for voice
Reads
opening a row
send_message
Continue a session that is not open elsewhere
Changes things
Your agent, when you ask
start_session
Start a session in an allowed folder
Changes things
Your agent, when you ask
stop_session
Stop a run this pack started
Changes things
Your agent, when you ask
A tool you turn off is never called: not by the widget, a control, or your agent. Tools that change things act in the app or service the widget connects to, when you or your agent use them.
What it runs
node server/index.mjs
A small server that comes with this widget, run by the companion with Node.js when the widget is on. You can read its code in the pack.
It receives: SIDEBUD_HOME, CLAUDE_CONFIG_DIR, CLAUDE_CODE_COMMAND, CLAUDE_SESSIONS_START_FOLDERS, CLAUDE_SESSIONS_RUNNING_MINUTES.
Keys and accounts
No keys or sign-in.
Keys and tokens are saved in your computer’s keychain. They never go to Sidebud.
Network
None declared beyond what it runs.
Setting it up
Install Claude Code 2.1.0 or newer and sign in (claude --version prints the version; claude update updates it). The pack uses your own Claude login and settings.
Needs Node.js 22 or newer, which the companion already runs on. Nothing else to install: the pack reads Claude Code's session files (~/.claude/projects, or CLAUDE_CONFIG_DIR) read-only.
To let the agent start new sessions, set Folders for new sessions to the folders it may use; until then starting is off. Continuing a session works in that session's own folder.
Sessions started or continued from here run headless: they cannot answer Claude's permission prompts, so tools your Claude settings do not already allow are refused.
