kargarisaac

Session State — Communication skill for Claude Code

Communication community

Claude Code mod: keeps what you asked and decided in a long chat in a session.md the agent can read.

How to install Session State

This entry records only its repository, not the path inside it, so there is no exact command to give. Open kargarisaac/session-state and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Session State does

Claude Code mod: keeps what you asked and decided in a long chat in a session.md the agent can read.

Alternatives in Communication

Internal Comms — Write internal communications like status reports, newsletters, and FAQs 94.1k ★
Claudix - Claude Code For VSCode — by Haleclipse - A VSCode extension that brings Claude Code directly into your editor with interactive chat int 1k ★
Post Threads — Publish multi-part text threads to Threads and X (Twitter) — split long-form ideas into a hook-first sequence 212 ★

README

session-state

A Claude Code mod that keeps a ledger of a long chat, so the agent does not forget what you asked, what you decided, what it learned the hard way, and which files matter. It writes the ledger after every turn, tells the agent where it is, and hands it back right after Claude Code compacts the chat. A side panel shows one line per turn.

The mod never changes, starts or blocks compaction. It only notices that one happened.

Install

In a Claude Code terminal session:

/plugin install session-state --marketplace kargarisaac/session-state

Answer `y` to add the marketplace, pick a scope, and paste your OpenRouter key when asked (it is stored as a secret). From a shell instead:

claude plugin install session-state --marketplace kargarisaac/session-state

The mod is active right away in that session and in every session you start after. After an update, run `/reload-plugins`. To try it from a clone without installing: `claude --plugin-dir `.

No OpenRouter key? Set the `gate` setting to `off` (see Privacy).

Use

Work as usual. Then:

/session-state opens one side panel with three tabs at the top (press 1, 2 or 3, or click): Steps (each turn with its outcome, files and the notes it added), Ledger (open asks, decisions and rules, learnings and files, colour-coded by kind, with a switch between Now and History) and Stats (recorder status, counts, models, cost and recent gate decisions). Colours come from your Claude Code theme.
/session-state steps | ledger | stats opens the panel on that tab.
/session-state close | pause | resume | retry | path | digest closes the panel, stops recording, resumes, re-runs failed turns, prints the folder, or prints what the agent gets after a compaction.
/session-state rebuild moves the chat's ledger files to before-rebuild/ (before-rebuild-2/ and on, for the next rebuilds) and reads the whole chat again from Claude Code's transcript. It leaves the