Repository navigation
Releases
Releases · ramene/remote-sessions
remote-sessions 0.3.3
- Fix: the Claude Code CLI upgrade stopped exporting $TMUX to plugin command subshells, which broke pane docking; detect the attached tmux client instead.
/remote-room(open-room) found no$TMUX, saidsplit:falseinside tmux, and printed the command. The tmux branch now askstmux list-clientsand docks beside the most recently active attached client (not the first one, which may be a worker or deploy pane). The cmux branch is unchanged and still first; the final fallback is unchanged. - The tmux split is 45% of the window width (it was 50%).
- Fix (s576): inside a tmux pane (
$TMUX_PANEset) the room splits beside THAT pane, the one it was started from. The 0.3.3 first cut ignored$TMUX_PANEand split beside the most recently active attached client's session, which could be another window. Without$TMUX_PANEthe attached-client rule above still applies. - Fix (s576): when a right column already holds a pane (the operator deck, or an earlier room), the room stacks under its top pane, so two panes stack on the right and no third column is added.
- Already on main, now in this release: the s554 clean-start commits (
crates/remote-sessions-cli/tests/clean_env.rs: a clean start lists every tool with all four hints) and the s554 Dockerfile and server.json entry for MCP registries. - New (s576 addendum): the MCP registry image.
server.jsonmoves to the 2025-12-11 schema (registryType; the obsolete packageversionis dropped), its image isghcr.io/ramene/remote-sessions:0.3.3. The Dockerfile copies the CA bundle from its build stage (no apt step in the runtime image) and carries the labelsio.modelcontextprotocol.server.nameandorg.opencontainers.image.source. New.github/workflows/ghcr.ymlpublishes that image (:0.3.3and:latest) when aremote-sessions-v*tag is pushed.server.jsonvalidates against the 2025-12-11 schema with 0 errors.
remote-sessions 0.3.2
- Fix: the control room shows every account session and the Routines by default (the 0.3.0/0.3.1 /remote-room showed only tracked sessions). Fixes #1.
/remote-roomandremote-sessions controlnow need no flag: whencloud-sessionscan read your account, the Cloud panel shows every session of your claude.ai account (name, repo, state, age) and the Routines with their newest runs. If the account list fails, the panel shows the sessions tracked on this machine and ONE line that says why and how to fix it (cloud-sessions auth use-claude-login). New:--tracked(orREMOTE_SESSIONS_CLOUD_ALL=0) for the old tracked-only view,--no-routines(orREMOTE_SESSIONS_ROUTINES=0) to hide the Routines.--alland--routinesare still accepted. - Fix: a session that is tracked here and is also in the account list is one row with the account's title; the same session tracked twice (
cse_andsession_forms) is one row. A session without a title shows the short form of its id (session_01AbCdEf…), not "(untitled)". - New: the first run guides you. Each panel says what is missing, in one line with the exact command: cloud-sessions not installed (
brew install ramene/tap/cloud-sessions), the Claude Code login not allowed yet (cloud-sessions auth use-claude-login, typed yes at a terminal), an account with no session (claude.ai/codeorcloud-sessions start), no Remote Control session here (claude remote-control --name box,remote-sessions serve --name box,--host a,bor~/.config/remote-sessions/hosts). With nothing to read, the room needs no login to say so. README "First run". - New: your account's Remote Control sessions that are connected on other machines (
environment_kindbridge,connection_statusconnected, not archived, in the account list) are rows of the Remote Control panel with the hostaccount, without ssh. The account list does not name the machine. Drop-in, approve and deny work by session id. One account list serves both panels. - cloud-sessions 0.2.2 (
list --unofficial) and a cloud-sessions whoselistcarries the account list (no--unofficial) both work.--trackedignores an account list inlist. - Fix:
/sessionsranremote-sessions sessions, a command that does not exist. It now prints one frame of the control room (control --once). - Fix: the room said Enter "watch" (cloud) and "attach" (Remote Control), but Enter opens the live, two-way chat with the session. One term in both panels now: the footer says
Enter/click open chat, the Selected panel saysEnter open the chat (two-way: type and press Enter to send, Esc back), and the cloud chat screen sayslive chat.cloud-sessions watch <id>is only the fallback in an error line, labeledread only: cloud-sessions watch <id>. - Fix: a long Cloud list no longer squeezes the Remote Control panel to one row: a list that fits in half the height gets all its rows (test
a_long_cloud_list_leaves_every_remote_control_row_visible). - Fix: when this machine's process list cannot be read and the account has Remote Control sessions elsewhere, the panel shows one error row for this machine and the account rows under it (before: only the error).
- cloud-sessions 0.2.3 reads every page of the account in plain
list. When a reply shows 0.2.3 or later (it hasview), the room's tracked lookups (the--trackedview, the fallback, the chat header) uselist --tracked, so one lookup does not fetch every page. With 0.2.2 they use plainlist. - Tests:
control_room.rs(default = account list + routines,--tracked, the fallback line and the login line, one row with the account title, an empty account, the account Remote Control rows, the first run in both panels, cloud-sessions without--unofficial,list --trackedwith 0.2.3, the open-chat wording in both panels, the account rows when ps fails);sessions-tuisnapshotroom_empty_cloud_absent_80x16. - Versions:
remote-sessions-cli,remote-sessions-coreandsessions-tuiare 0.3.2; the plugin is 0.3.2.
remote-sessions 0.3.1
- Fix:
<command> --helpand<command> -hwork for every command. Before,control --helpprinted{"error":"Unknown option --help.","ok":false}and exited 1, andcontrol -hstarted the room. Now the help of a command shows its usage lines (from the top-level help), its options and, forcontrolandattach, its keys, and exits 0. The command does not run. - New:
help <command>shows the same text.help,--helpand-hshow the top-level help, which now has ahelpline.help <name>for a name that is not a command is an error (exit 1). - Unchanged: an unknown option still fails with
Unknown option --<name>.(exit 1). A--helpor-hthat is the value of an option (send <session> --message --help) is text, not a help request. - Tests:
tests/help.rshas one test per command (--help,-handhelp <command>: exit 0, the same text, the command name in it), the options and keys ofcontrol, unknown options, and a check that each option in the usage has a help text. - Security: through MCP,
remote_approveandremote_denynow do nothing by default. They return the exact command for the user to run (remote-sessions approve <session> --request <id>,/remote-approve, ora/dincontrol). A model cannot change the environment of the MCP server that already runs, so it cannot answer a permission prompt by itself. To let the MCP tools act, setREMOTE_SESSIONS_MCP_APPROVE=1in the environment that starts Claude Code. The CLIapproveanddeny,/remote-approveand the control room are unchanged. Tests:tests/mcp_tools.rs(off for unset,0,true,yesand empty, with no token read; on only with1). - Security: the login token goes only to
https://api.anthropic.com.REMOTE_SESSIONS_APInow accepts only that address, or plain http to a loopback test server; before, any https address was accepted. Test:the_token_goes_only_to_api_anthropic_com(remote-sessions-core,src/api.rs). - New: several machines in the control room and in
list. The Remote Control panel lists this machine (always, labeled with its short host name) and the machines of--host a,b(comma list, repeatable),REMOTE_SESSIONS_HOSTSand~/.config/remote-sessions/hosts(one ssh host per line,#comments), merged in that order, each once. Each machine is listed with thelist --hostcall (ssh -n -o BatchMode=yes -o ConnectTimeout=5), one thread per machine, stopped after 8 s; a machine that fails gets its own row (vm-1 ssh timed out) and never hides the others. Rows get a host column, and the panel title counts the sessions of each machine. Drop-in, approve, deny, read and say use the session API by claude.ai id, so they work for any machine;stopstill needs--host(a signal over ssh).list(CLI and MCPremote_list) takes the same sources and gives each worker ahost(one--hostkeeps the old output)./remote-roompassesREMOTE_SESSIONS_HOSTSinto a tmux split. - Security: an ssh host name is an ssh config name or a host name (letters, digits,
.,_,-;user@allowed); a leading-(-oProxyCommand=...), spaces and other characters are refused before ssh runs. Before,:and[]were also accepted. Tests:tests/hosts.rs(a stub ssh on PATH with two machines that answer and one that times out; the three sources and their order; the room rows, host column and counts; the refusals),rc.rs(host_names_refuse_options_and_odd_characters,a_slow_command_is_stopped_at_the_limit),sessions-tui/tests/room.rs(several_hosts_get_a_host_column_counts_and_a_row_for_a_host_that_failed). - Docs: README "Security and trust": your login, the hosts in the code, the risks, and how to report a security problem. README.zh-CN has a short version.
- Versions:
remote-sessions-cli,remote-sessions-coreandsessions-tuiare 0.3.1; the plugin is 0.3.1.
remote-sessions 0.3.0
- Open source: the control room (
control) andattach --tuiare now open, MIT, like the rest of this repo. There is no gate and no paid tier for them; the README has a new "Control room" section with the commands, the keys and four frames (docs/images), andcrates/sessions-tui/examples/mock_frames.rsprints those frames from the real code. sessions-tui: a small panel interface (RoomPanel,PanelSpec,PanelRow,PanelSnapshot). The room draws Remote Control and Cloud, plus any panels the host program gives it; a panel is shown only after its first read answers.Sel::Panel(index, id)andRoomMsg::Panel(index, snapshot)carry them;RoomBackend::panels()/panel(k)read them. The public build gives none./remote-room(open-room): inside cmux it splits withcmux new-split right --command(detected byCMUX_SURFACE_ID/CMUX_WORKSPACE_IDand acmuxon PATH), else inside tmux withtmux split-window -h, else it prints the command. The JSON line names themux. README: "Attach from tmux or cmux". Tests:tests/open_room.rs(stub cmux and tmux, no real split).- Docs:
docs/getting-started.md: install (Homebrew or the plugin), login, first steps, the control room, tmux and cmux, and cloud-sessions, with a picture for each step (docs/images/install-*.svg,plugin-list.svg,remote-room-split.svg). README and README.zh-CN have a short "Getting started" section that links it. - Versions:
remote-sessions-cli,remote-sessions-coreandsessions-tuiare 0.3.0 (sessions-tui was 0.1.0; its room API changed). - New:
controlis a styled, clickable, interactive control room over Remote Control sessions and cloud sessions: two bordered panels (Remote Control with a pause badge on sessions that wait on a permission prompt, and Cloud with title, repo, state, last activity and age), a panel for the selected session, a status line and a footer of actions. Arrow keys or a click select a row, Enter or a second click drops in (attach <id> --tui, orcloud-sessions watch <id>, in the same terminal),a/dapprove or deny a waiting prompt after ay(never Enter),ssends a follow-up to a cloud session (the text goes on stdin),rrefreshes,q, Esc, Ctrl-C or a click on the close button in the header leave. The wheel scrolls the panel under the pointer. Remote Control refreshes every 3 s and cloud every 10 s, each a single call; the newest event of a cloud session is read for the selected row only, one at a time. The terminal is restored on every exit path,NO_COLOR/--no-color/--asciigive a colorless ASCII look, narrow terminals drop columns, and below 30x9 it says so.control --once [--size WxH]prints one frame and exits;control --demouses placeholder sessions. Cloud sessions raise no permission prompts, so there is no approve for them. - New:
attach <session> --tuiopens a full-screen terminal UI (new cratesessions-tui, MIT,ratatui+crossterm, threads andstd::sync::mpsc, no async runtime). Transcript with message, tool-call and folded tool-result blocks, a prompt box, a one-row footer (session, host, mode, link, hints), and a permission modal (allow once, deny, deny with a reason). Keys: Enter sends, Shift/Alt-Enter newline, Esc interrupts the running turn, Tab cycles manual / accept-edits / plan (/modereaches the rest), Ctrl-O folds and unfolds results, PgUp/PgDn scroll, Ctrl-C leaves WITHOUT stopping the session. Slash commands:/approve,/deny,/mode,/read,/interrupt,/mouse,/log,/help,/quit.NO_COLOR,--no-colorand--asciigive a colorless ASCII look; narrow terminals drop footer segments. Plainattachis unchanged, and--tuiwithout a terminal falls back to it. - Core:
events::blocks(payload)returns tool_use, tool_result, thinking and control_request/response/cancel as structured items (parse_eventis untouched);control::user_payload_asandClient::say_assend a user turn with a caller-chosen event uuid, so a UI can match the server's echo.
remote-sessions 0.2.3
remote-sessions 0.2.3
- Linux: use the Claude Code login from ~/.claude/.credentials.json. Token order for events, read, pending, approve, deny, say, interrupt, mode, stream and attach: REMOTE_SESSIONS_TOKEN, then ~/.config/remote-sessions/token, then the macOS keychain login (macOS only), then claudeAiOauth.accessToken from $CLAUDE_CONFIG_DIR/.credentials.json (when CLAUDE_CONFIG_DIR is set) or ~/.claude/.credentials.json (all platforms). Before, Linux found no token although claude auth status said loggedIn: true (s461). The file is only read: an expired login (expiresAt in the past) is an error ("the Claude Code login has expired: run claude once to refresh it"), not a stale request. Bad JSON or a missing accessToken key gives a clear error. No error text carries a token.
- Tests: tests/token.rs (valid, expired, missing key, bad JSON, missing file, file mode 0644 accepted, CLAUDE_CONFIG_DIR, and the precedence order).
- MCP: every tool now declares a title and all four tool annotation hints as booleans (readOnlyHint, destructiveHint, idempotentHint, openWorldHint; MCP spec 2025-06-18). Changed values: remote_approve and remote_deny are destructive (an approved tool can change or delete files; a denied tool call cannot be redone); remote_list and remote_stop are open-world (with host they run over ssh).
- Tests: tests/mcp_tools.rs has one test per MCP tool, by name: its hints and its argument checks (no network, no ssh, no signal).
remote-sessions 0.2.2
- 0.2.2: privacy: examples and defaults no longer name the authors machines or sessions; default recording host is localhost