cardak

A project-centric deck for WezTerm panes and Claude Code sessions. It groups every pane by project, jumps to a pane with Enter, gives each project its own color scheme, and shows which Claude Code session is waiting on you, and why.

Linux and WezTerm only. Developed on Kubuntu 24.04 (KDE Plasma, X11).

Install

uv tool install 'cardak[all] @ git+https://github.com/brlauuu/cardak'
cardak

[all] brings every optional part. Without it (uv tool install git+https://github.com/brlauuu/cardak) you get the deck, agent status, themes, resources, the phone view and the PM view, and add what you want:

Extra	Adds	Size
background	the project background's ASCII art (Pillow, pyfiglet, resvg-py)	~33 MB
anthropic	waiting summaries by Anthropic's API (the SDK); Ollama, Fireworks, OpenAI and Codex need nothing	~37 MB

A feature whose extra is missing says so where it's used, with the command that adds it. To add one later, install again with it, e.g. uv tool install --reinstall 'cardak[all] @ git+…'. From a clone: uv tool install --editable '.[all]'.

The deck lists every WezTerm pane grouped by project. Projects come from ~/.config/cardak/projects.toml; repos you haven't configured are grouped by their git root, and a adds one.

Enter on a pane jumps to it; Enter on a project jumps to its first Claude Code session (else its first pane). ← folds a project away (from any line inside it too), → unfolds it, and space toggles it.

[[project]]
name  = "webshop"
path  = "~/repos/webshop"
theme = "Catppuccin Mocha"   # optional; or press `t` in the deck

Jumping and themes

cardak wezterm install

This installs ~/.config/wezterm/cardak.lua and prints one line to add to your wezterm.lua: require('cardak').apply(config). cardak never edits wezterm.lua itself. The module raises the window you jump to, applies each project's color scheme, names each tab after its project (webshop · ✳ Fix the cart), and tells the deck which pane you're looking at. Tabs outside a project, and tabs you've titled yourself, keep WezTerm's title. WezTerm uses only one tab-title handler; if you have your own, use require('cardak').apply(config, { tab_titles = false }). After upgrading cardak, run the command again when the deck asks you to.

cardak themes zsh adds an optional zsh hook that tints each pane's background by project.

Project background

Each project's windows show its logo, or else its name, as faint ASCII art in the bottom-right corner, in the color of its scheme's text. cardak makes the art once, when the project is added: from the first image in its README or a file named like a logo, mark or icon, skipping wordmarks that would be unreadable in characters; otherwise the name in large letters. The art is a text file, ~/.config/cardak/logos/<project>.txt, and from then on it's yours: paste any ASCII art into it to replace it, at any size. cardak never makes it again, so a deleted file means no background for that project.

In the theme picker (t), ctrl+b turns a project's background off or on, previewed live, and the picker shows where its file is. In projects.toml, [background] takes enabled = false (every project) and opacity (default 0.06). The art sits in the bottom-right corner; position = [columns, rows] under [background] places it that many cells left of the window's right edge and down from its top instead, and a project's own background_position wins over that. Art that doesn't fit a small window is cut off. A background set in your wezterm.lua before require('cardak').apply(config) wins; apply(config, { background = false }) turns cardak's off. The background covers the zsh tint. After upgrading, run cardak wezterm install again (the deck reminds you).

Claude Code status

cardak hooks install

This adds cardak's hooks to ~/.claude/settings.json. It shows what it will add, backs the file up next to itself, and asks before writing. Your own hooks are left as they are, and so is the rest of the file's content and its indent; only hand formatting such as an array kept on one line is spread over several. cardak hooks status checks it, and cardak hooks uninstall removes only cardak's entries. Sessions started before the install report nothing. Claude Code also holds hooks back in a folder until you accept its "trust this folder" prompt.

In the deck:

• Each Claude pane has a dot: orange waiting on you, green working, grey idle.
• Waiting on you, at the top, lists waiting sessions oldest first, with the reason: Approve a tool (and which), Your answer (it asked something), or Turn finished. Enter jumps there. Jumping to a session, or looking at its pane for a second, marks it seen.
• w shows only the waiting sessions. i on a session shows what it needs, your last prompt and what this turn changed. t there opens the full transcript.

When a session starts waiting, you get one desktop notification and one sound, even with the deck closed. You get none if you're already looking at that pane. Configure it in projects.toml:

[notify]
desktop = true                 # notify-send
waiting_sound = "random"       # a session waiting on you
memory_sound = "random"        # memory alerts, and WezTerm closed for lack of memory
other_sound = "random"         # every other alert: a chime
sounds_dir = "~/sounds/cardak" # optional: your own .wav/.oga/.ogg/.mp3 files join the waiting pool

Each sound is "random", "off" (the notification still shows) or a name: a built-in one (chime, pluck, bell, blip, drop), a file in sounds_dir, or a pack clip as <pack folder>/<file name without extension>, or with it (<pack folder>/A.mp3) when two clips share a name. An empty "" is the same as leaving the key out. The older sound key still works and stands for waiting_sound; sound = "off" with none of the three set silences them all, as it did before there were three.

여기까지가 README 앞부분입니다. 나머지는 원문에서 읽을 수 있습니다. README 전문 보기 ↗