serenity — one calm map for your Claude Code sessions

serenity

serenity — 200×50

◈ mindmap  serenity
2 need you
zoom: map

←↑↓→ WASD move · Enter open · i message · Ctrl+m master
? shortcuts

serenity — claude — 92×28

~/projects/serenity $ claude
session started · cwd ~/projects/serenity
> write the release notes for v0.4
• Read(CHANGELOG.md)
  └  Read 142 lines
• Bash(git log v0.3.0..HEAD --oneline)
  └  38 commits
• Write(docs/release-notes/v0.4.md)
◦ Drafting… (14s)
> █
  ? for shortcuts

✓ release-notes

PR #479 approved

Drafted the v0.4 notes from 38 commits.

serenity — claude — 88×24

> update the install guide for the new flags
• Read(docs/install.md)
  └  Read 96 lines
• Update(docs/install.md)
  └  Updated docs/install.md with 12 additions and 4 removals
• Bash(bun run docs:build)
  └  Running…
◦ Building docs… (41s)
> █

install-docs

no PR yet

Updated the install guide for the new flags.

serenity — claude — 86×26

> make the e2e suite retry on timeouts
• Update(e2e/run.ts)
Edit file
e2e/run.ts
 41 -   await page.waitForSelector(sel);
 41 +   await retry(() => page.waitForSelector(sel), 3);
Do you want to make this edit to run.ts?
❯ 1. Yes
  2. Yes, and don't ask again this session
  3. No, and tell Claude what to do differently

◐ flaky-e2e WAITING

no PR yet

Wants to edit e2e/run.ts to retry on timeout.

session.ts — serenity

EXPLORER
⌄ SERENITY
⌄ packages
⌄ core
⌄ src
TS domain.ts
TS keychain.ts
TS session.ts
TS storage.ts
› daemon
› tui
M↓ README.md

TSsession.ts●

TSkeychain.ts

M↓README.md

packages › core › src › session.ts

1import { Keychain } from "./keychain";
2import type { Session } from "./domain";
3
4// Tokens leave SQLite and live in the OS keychain.
5export async function saveToken(session: Session, token: string) {
6  const key = `serenity:${session.id}`;
7  await Keychain.set(key, token);▏
8  return { ...session, tokenRef: key };
9}
10
11export async function loadToken(session: Session) {
12  if (!session.tokenRef) return null;
13  return Keychain.get(session.tokenRef);
14}

⎇ auth-refactor*    ⊗ 0  ⚠ 2
Ln 7, Col 31    Spaces: 2    UTF-8    TypeScript

● auth-refactor

PR #482 checks running

Moving session tokens into the OS keychain.

Search Northwind

Northwind ⌄

# general

# eng-platform1

# deploys

# random

Direct messages

● Priya Raman1

● Jake Miller

○ Ananya Desai

# eng-platform ⌄

Jake Miller 10:39

CI is red again on main. Anyone on it?

New

Priya Raman 10:41

@mukkund is the deploy blocked on #482?

Ananya Desai 10:42

lunch at 12:30? also who has the standup notes

Message # eng-platform

BIS⌁➤

◆ master

watching 4 sessions, 1 thread

NEEDS YOU

◐ flaky-e2e

wants to edit e2e/run.ts

◆ approve the edity e n

# eng-platform · Priya

is the deploy blocked on #482?

◆ reply "Not blocked, checks running."y e n

◆ master › Two things need you. Everything else is quiet.

› █

Chatnow

Priya Raman: @mukkund is the deploy blocked?

GitHubnow

3 new comments on serenity#482

It started with one Claude session.

and then…

Bring serenity into your flow.

Clutter Distraction Noise

SCROLL ↓

Bring focus to your Claude Code.

Serenity uses your existing Claude subscription.

$ curl -fsSL https://raw.githubusercontent.com/mukkund1996/serenity/main/scripts/install.sh | sh

macOS and LinuxFull install guide ↓

● auth-refactor

PR #482 checks running

Moving session tokens into the OS keychain.

ClutterHarmony

Every Claude Code session is a node in the mind map.

◐ flaky-e2e WAITING

no PR yet

Wants to edit e2e/run.ts to retry on timeout.

DistractionFocus

Working agents stay quiet. Waiting agents call you.

◆ master

watching 4 sessions, 1 thread

NEEDS YOU

◐ flaky-e2e

wants to edit e2e/run.ts

◆ approve the edity e n

# eng-platform · Priya

is the deploy blocked on #482?

◆ reply "Not blocked, checks running."y e n

◆ master › Two things need you. Everything else is quiet.

› █

NoiseClarity

The master contains the overview and can control everything.

INSTALL

Serenity in one command.

Designed for macOS and Linux.

Install

Using the script

$ curl -fsSL https://raw.githubusercontent.com/mukkund1996/serenity/main/scripts/install.sh | sh

Or with Homebrew

$ brew install --cask claude-code; brew install mukkund1996/tap/serenity

View the source on GitHub

Bring focus to your Claude Code.

Serenity in one command.

Install