chatdeck 0.1.0__py3-none-any.whl

chatdeck/windows/focus_wt.ps1

@@ -0,0 +1,68 @@
+# Brings the Windows Terminal tab titled $env:DASH_MARK to the front, on any virtual desktop, and
+# optionally types $env:DASH_TYPE into it.
+# Used by terminals.py; set $env:DASH_VDLIB to VirtualDesktopLib.cs to switch desktops reliably.
+$m = $env:DASH_MARK; $lib = $env:DASH_VDLIB
+Add-Type -AssemblyName UIAutomationClient, UIAutomationTypes
+Add-Type @'
+using System; using System.Text; using System.Runtime.InteropServices; using System.Collections.Generic;
+public static class F {
+  delegate bool P(IntPtr h, IntPtr l);
+  [DllImport("user32.dll")] static extern bool EnumWindows(P cb, IntPtr l);
+  [DllImport("user32.dll", CharSet=CharSet.Unicode)] static extern int GetWindowText(IntPtr h, StringBuilder s, int n);
+  [DllImport("user32.dll", CharSet=CharSet.Unicode)] static extern int GetClassName(IntPtr h, StringBuilder s, int n);
+  [DllImport("user32.dll")] static extern bool IsIconic(IntPtr h);
+  [DllImport("user32.dll")] static extern bool ShowWindow(IntPtr h, int c);
+  [DllImport("user32.dll")] static extern bool SetForegroundWindow(IntPtr h);
+  [DllImport("user32.dll")] public static extern IntPtr GetForegroundWindow();
+  [DllImport("user32.dll")] static extern void keybd_event(byte k, byte s, uint f, UIntPtr e);
+  [DllImport("dwmapi.dll")] static extern int DwmGetWindowAttribute(IntPtr h, int a, out int v, int s);
+  public static List<IntPtr> Terminals() { var r = new List<IntPtr>();
+    EnumWindows((h, l) => { var c = new StringBuilder(64); GetClassName(h, c, 64);
+      if (c.ToString() == "CASCADIA_HOSTING_WINDOW_CLASS") r.Add(h); return true; }, IntPtr.Zero); return r; }
+  public static string Title(IntPtr h) { var t = new StringBuilder(512); GetWindowText(h, t, 512); return t.ToString(); }
+  public static bool Cloaked(IntPtr h) { int v; DwmGetWindowAttribute(h, 14, out v, 4); return v != 0; }   // on another virtual desktop
+  public static bool Raise(IntPtr h) {
+    if (IsIconic(h)) ShowWindow(h, 9);
+    keybd_event(0x12, 0, 0, UIntPtr.Zero); keybd_event(0x12, 0, 2, UIntPtr.Zero);   // Alt tap lets us take focus
+    return SetForegroundWindow(h);
+  }
+}
+'@
+$vd = $false
+function Show($h) {
+  if ([F]::Cloaked($h) -and $lib -and (Test-Path $lib)) {
+    if (-not $script:vd) { Add-Type -Path $lib; $script:vd = $true }
+    [VirtualDesktop.Desktop]::FromWindow($h).MakeVisible(); Start-Sleep -Milliseconds 250
+  }
+  [F]::Raise($h) | Out-Null
+}
+$A = [System.Windows.Automation.AutomationElement]
+$tabCond = New-Object System.Windows.Automation.PropertyCondition($A::ControlTypeProperty, [System.Windows.Automation.ControlType]::TabItem)
+function Tab($h) {   # the tab carrying the mark, if this window's tabs are readable (not on another desktop)
+  foreach ($t in $A::FromHandle($h).FindAll([System.Windows.Automation.TreeScope]::Descendants, $tabCond)) { if ($t.Current.Name -eq $m) { return $t } }
+}
+function Done($h) {
+  # With $env:DASH_TYPE set, type that text into the chat and press Enter - but only once the chat's
+  # terminal really is the window in front, so keystrokes never land anywhere else.
+  if ($env:DASH_TYPE) {
+    Start-Sleep -Milliseconds 400
+    if ([F]::GetForegroundWindow() -ne $h) { "notfront"; exit }
+    Add-Type -AssemblyName System.Windows.Forms
+    [System.Windows.Forms.SendKeys]::SendWait($env:DASH_TYPE + "{ENTER}")
+  }
+  "ok"; exit
+}
+for ($i = 0; $i -lt 6; $i++) {   # the terminal takes a moment to pick up the new title
+  $wins = [F]::Terminals()
+  foreach ($h in $wins) { if ([F]::Title($h) -eq $m) { Show $h; Done $h } }
+  foreach ($h in $wins) { if (-not [F]::Cloaked($h)) { $t = Tab $h; if ($t) {
+    $t.GetCurrentPattern([System.Windows.Automation.SelectionItemPattern]::Pattern).Select(); Show $h; Done $h } } }
+  Start-Sleep -Milliseconds 250
+}
+# Last resort: a background tab in a window on another desktop. Those tabs can only be read once
+# the window is on screen, so visit each such window, then go back if the chat isn't there.
+$back = [F]::GetForegroundWindow()
+foreach ($h in $wins) { if ([F]::Cloaked($h)) { Show $h; Start-Sleep -Milliseconds 300; $t = Tab $h; if ($t) {
+  $t.GetCurrentPattern([System.Windows.Automation.SelectionItemPattern]::Pattern).Select(); Done $h } } }
+if ($back -ne [IntPtr]::Zero) { Show $back }
+"missing"

chatdeck/windows/start.ps1

@@ -0,0 +1,35 @@
+# chatdeck launcher for Windows (written by `chatdeck autostart on`): starts the chatdeck server
+# in WSL if it isn't running, then the corner bubble and tray icon. With -Open it also opens the
+# full dashboard window, or brings it forward if it's already open.
+param([switch]$Open)
+$Port = __PORT__
+$Distro = "__DISTRO__"
+$Cmd = "__CMD__"
+$Url = "http://127.0.0.1:$Port/"
+[System.Net.WebRequest]::DefaultWebProxy = $null
+function Up { try { (Invoke-WebRequest -UseBasicParsing -TimeoutSec 2 $Url).Content -match "<title>chatdeck</title>" } catch { $false } }
+
+if (-not (Up)) {
+  # A login shell, so the server finds `claude` on the same PATH as in a terminal.
+  Start-Process wsl.exe -ArgumentList "-d $Distro -- bash -lc ""$Cmd serve --port $Port""" -WindowStyle Hidden
+  for ($i = 0; $i -lt 60 -and -not (Up); $i++) { Start-Sleep -Milliseconds 500 }
+}
+
+Start-Process powershell.exe -WindowStyle Hidden -ArgumentList "-NoProfile", "-WindowStyle", "Hidden", "-ExecutionPolicy", "Bypass",
+  "-File", "$PSScriptRoot\bubble.ps1", "-Port", "$Port"
+
+if ($Open) {
+  Add-Type -Namespace Chatdeck -Name W -MemberDefinition @'
+[DllImport("user32.dll", CharSet=CharSet.Unicode)] public static extern IntPtr FindWindow(string c, string t);
+[DllImport("user32.dll")] public static extern bool SetForegroundWindow(IntPtr h);
+[DllImport("user32.dll")] public static extern bool ShowWindow(IntPtr h, int c);
+'@
+  $h = [Chatdeck.W]::FindWindow("Chrome_WidgetWin_1", "chatdeck")
+  if ($h -ne [IntPtr]::Zero) { [Chatdeck.W]::ShowWindow($h, 9) | Out-Null; [Chatdeck.W]::SetForegroundWindow($h) | Out-Null }
+  else {
+    $b = @("$env:ProgramFiles\Google\Chrome\Application\chrome.exe", "${env:ProgramFiles(x86)}\Google\Chrome\Application\chrome.exe",
+           "$env:LOCALAPPDATA\Google\Chrome\Application\chrome.exe", "${env:ProgramFiles(x86)}\Microsoft\Edge\Application\msedge.exe") |
+         Where-Object { Test-Path $_ } | Select-Object -First 1
+    if ($b) { Start-Process $b -ArgumentList "--app=$Url", "--window-size=520,900" } else { Start-Process $Url }
+  }
+}

chatdeck-0.1.0.dist-info/METADATA

@@ -0,0 +1,164 @@
+Metadata-Version: 2.4
+Name: chatdeck
+Version: 0.1.0
+Summary: A local dashboard for your Claude Code chats: what's running, what needs you, and what it costs.
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/Abdifatah09/chatdeck
+Project-URL: Issues, https://github.com/Abdifatah09/chatdeck/issues
+Keywords: claude,claude-code,dashboard,ai,cli
+Classifier: Environment :: Console
+Classifier: Environment :: Web Environment
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# chatdeck
+
+A local dashboard for your Claude Code chats: see which chats are running and which need you,
+read and search old chats, track usage against your plan limits, and clean up transcripts.
+Python 3.9+ standard library only, no dependencies.
+
+![A tour of chatdeck: a chat waiting for permission, chats grouped by project, searching and reading an old chat, and the light theme](https://raw.githubusercontent.com/Abdifatah09/chatdeck/main/docs/media/tour.gif)
+
+## Features
+
+- **Running now** – every live session with its context size and cost. Sessions stuck on a
+  permission prompt or a question get an amber **Waiting for you** badge and an optional chime.
+  **Open** jumps to the chat's terminal tab, **Rename** runs `/rename` in it so Claude names it after what it's about (double-click the name to type your own), and big chats get a
+  **Compact** button that runs `/compact`.
+- **Saved chats** – read any chat without resuming it, search across all messages,
+  rename (so you know what's in it), export to Markdown, resume in a terminal, delete.
+- **Usage** – tokens today and this week, top projects, 24h cost, and your 5-hour and weekly
+  limits with a forecast of when you'd hit them at the current pace.
+- **Cleanup** – delete empty chats or chats older than 7, 30 or 90 days. Shows disk usage.
+  Running chats are never deleted.
+- **By project** view: one section per project (git repo, including its worktrees and subfolders)
+  with its running and saved chats, and a **New chat** button that starts Claude Code in that project. Sort by recent, size, cost or messages. Light and dark themes.
+  Keyboard shortcuts: `/` search, `j`/`k` move, `Enter` read, `r` resume, `e` rename, `x` select, `Del` delete, `?` help.
+- **Windows corner button and tray icon** – pop the dashboard up from the corner of the screen.
+
+## Install
+
+```sh
+pipx install chatdeck          # once it's on PyPI; until then:
+pipx install git+https://github.com/Abdifatah09/chatdeck
+```
+
+No pip? Clone the repo and run `./install.sh`. It puts a `chatdeck` command in `~/.local/bin`
+that runs straight from the clone.
+
+## Try it first
+
+```sh
+chatdeck demo
+```
+
+opens chatdeck on a set of made-up chats (in a temporary folder, deleted when you stop it with Ctrl+C),
+so you can click around without touching your own. The screenshots here are from the demo.
+
+## Use
+
+```sh
+chatdeck                  # start the dashboard and open it
+chatdeck setup            # add the Claude Code hooks for plan limits and "waiting for you"
+chatdeck autostart on     # start it at login (Windows via WSL, macOS, Linux)
+chatdeck bubble           # Windows: the corner button and tray icon
+chatdeck demo             # try it with made-up chats
+chatdeck stop             # stop the background server
+chatdeck uninstall        # take the hooks and autostart out again
+```
+
+`chatdeck setup` keeps your existing status line: it saves the usage data first, then runs
+yours, so your status line looks the same. `chatdeck uninstall` puts it back, and your previous
+settings are backed up in `~/.chatdeck/backups`.
+
+## Privacy and security
+
+- Everything stays on your machine. chatdeck reads the transcripts Claude Code already writes to
+  `~/.claude/projects` and sends nothing anywhere: no accounts, no telemetry, no network calls
+  except to itself.
+- The server binds to 127.0.0.1 only. Every API call needs a token that changes each run, sent in a
+  custom header, so other websites open in your browser can't call it.
+- It only changes things you ask it to: deleting a chat removes its transcript (running chats are
+  never deleted), renaming adds a title line to it, and Rename and Compact on a running chat type
+  `/rename` or `/compact` into that chat's terminal, only while it's idle.
+- `chatdeck setup` edits `~/.claude/settings.json` and backs it up first; `chatdeck uninstall` undoes it.
+
+## See it in action
+
+| Find any chat by what was said in it | Every project in one place |
+|---|---|
+| ![searching for "upgrade" and opening the matching chat](https://raw.githubusercontent.com/Abdifatah09/chatdeck/main/docs/media/search.gif) | ![switching to the by-project view, folding a project and the New chat button](https://raw.githubusercontent.com/Abdifatah09/chatdeck/main/docs/media/projects.gif) |
+
+| Keyboard only: `j`/`k`, `Enter`, `e` to rename, `?` for help | Running chats, at a glance |
+|---|---|
+| ![moving through saved chats, reading one and renaming it from the keyboard](https://raw.githubusercontent.com/Abdifatah09/chatdeck/main/docs/media/keyboard.gif) | ![three running chats: one waiting for permission, one working, one getting big](https://raw.githubusercontent.com/Abdifatah09/chatdeck/main/docs/media/running.png) |
+
+## Screenshots
+
+![chatdeck showing three running chats, one waiting for permission, plan limits and a week of usage](https://raw.githubusercontent.com/Abdifatah09/chatdeck/main/docs/dashboard.png)
+
+| By project | Reading a chat |
+|---|---|
+| ![chats grouped by project](https://raw.githubusercontent.com/Abdifatah09/chatdeck/main/docs/by-project.png) | ![a saved chat open in the viewer](https://raw.githubusercontent.com/Abdifatah09/chatdeck/main/docs/viewer.png) |
+
+| Light theme | The Windows pop-up |
+|---|---|
+| ![the light theme](https://raw.githubusercontent.com/Abdifatah09/chatdeck/main/docs/light.png) | ![the pop-up from the corner button](https://raw.githubusercontent.com/Abdifatah09/chatdeck/main/docs/popup.png) |
+
+## Windows corner button and tray icon
+
+A small always-on-top button sits in the bottom-left corner of the screen. Click it and the
+dashboard pops up above it; click again, or anywhere else, and it tucks away. The badge counts
+running chats and turns amber, with a pulsing ring, when one is waiting for you. Drag it to move
+it; right-click to hide it or for more. The same badge sits in the notification area by the
+clock, where a click pops the dashboard up in the bottom-right corner. It needs Chrome or Edge.
+Start it with `chatdeck bubble`, or let `chatdeck autostart on` start it at login.
+
+## Terminals
+
+**Resume**, **Open** and **Agents view** open or find a terminal for you:
+
+| Platform | Opens chats in | Open on a running chat |
+|---|---|---|
+| WSL | Windows Terminal (a new window each time) | finds its tab on any virtual desktop and switches to it |
+| macOS | Terminal, or iTerm2 if you run the dashboard from it | finds its tab by tty |
+| Linux | gnome-terminal, konsole, kitty, alacritty, wezterm, xfce4-terminal, tilix, foot or xterm | finds its window with `wmctrl` or `xdotool` (X11) |
+
+When no terminal can be opened, the dashboard copies the command to paste instead.
+Finding a running chat works by briefly giving its tab a unique title, so it doesn't work for
+tabs whose title is locked (Windows Terminal's `suppressApplicationTitle`).
+
+## Settings
+
+Settings live in `~/.chatdeck/config.json`, and environment variables override them:
+
+- `port` / `CHATDECK_PORT`: default 47123
+- `terminal` / `CHATDECK_TERMINAL`: which terminal to use, e.g. `kitty` or `iterm`
+- `tabs` / `CHATDECK_TABS` (WSL): `true` opens chats as tabs in your last Windows Terminal window instead of a new window each
+- `vdlib` / `CHATDECK_VDLIB` (WSL): Windows path to [VirtualDesktopLib.cs](https://github.com/MScholtes/VirtualDesktop),
+  which makes switching to a chat on another virtual desktop reliable
+- `CHATDECK_DIR`: where chatdeck keeps its data, default `~/.chatdeck`
+
+## Tests
+
+```sh
+python3 -m unittest discover -s tests
+```
+
+## Screenshots and videos
+
+Everything in `docs/` is recorded from `chatdeck demo` by a script, so it can be redone after UI changes
+(needs Node; uses Segoe UI from `/mnt/c/Windows/Fonts` when run under WSL):
+
+```sh
+cd scripts/promo && npm install && npx playwright-core install chromium-headless-shell
+npm run record                    # or just some: npm run record -- shots tour search projects keyboard
+```
+
+It writes the README screenshots to `docs/` and the GIFs, MP4s, framed screenshots and a 1280×640
+social preview card to `docs/media/`.

chatdeck-0.1.0.dist-info/RECORD

@@ -0,0 +1,26 @@
+chatdeck/__init__.py,sha256=naiHQ5__Xp-CLtjKv2NWz_2wEw5fZbvWEKH0XniAy1A,79
+chatdeck/__main__.py,sha256=bYt9eEaoRQWdejEHFD8REx9jxVEdZptECFsV7F49Ink,30
+chatdeck/autostart.py,sha256=NjZtpNRYA48uCa_91AH80ktW0m2-m13AjtliLuvA8pU,5144
+chatdeck/cli.py,sha256=bAjLmm1dSul18cjWUknidE-oHZmLa1kA2zCQyg8_uOM,7135
+chatdeck/config.py,sha256=n8bjCfk9T-59EFeMzxUx3oiynPEm_vDBeHcgI5soTMM,1034
+chatdeck/demo.py,sha256=B1fRshU4JW4bz6cEUG5-_RwFVqhR6O9vRrN6OvN1w5I,9906
+chatdeck/desktop.py,sha256=HowVaaHvZW5GaAd2RBPwDJ57Qu_p_LUGweeoHYmMfg0,4669
+chatdeck/hooks.py,sha256=KSBbqVpVHXWE-2AoscQaIpzhFfMOTjC_G94oeLxVTuI,5578
+chatdeck/server.py,sha256=39TubZww5zeD4cD9hDwxbOnSBf_s78iNB63QPIMwZV8,18396
+chatdeck/terminals.py,sha256=Ado3dn9OjoGo49NxyEd1YxpbK7FmAp2h-b02VKSRrAQ,9431
+chatdeck/transcripts.py,sha256=bFoD53CluwSHzrRHSFzj_TWlU4zDzDVJHLBROSiJLMU,10158
+chatdeck/usage.py,sha256=Hu7tmj0dJl8iNQtYwkw6BJhDU_K38oFqcoaImdPNfsA,4739
+chatdeck/static/index.html,sha256=g7IUn3Rsblq5IzPvHUnIrbWz-w1UZCJx93NkZ5ssvEk,38412
+chatdeck/static/logo-192.png,sha256=Dp9ZJJYHiG6GwTKX9vMCI69nn0Jr0jQowYvGjOumBXM,11287
+chatdeck/static/logo-512.png,sha256=4_-BdCcVR5gqEBZvk5l6au_4w9Pv8cZmG0Sv2Rshsno,58695
+chatdeck/static/logo.ico,sha256=qyXoiqBNwKAOkrDybrROQvIeEReKUhdQ7dv7Y1gId3A,21571
+chatdeck/static/logo.svg,sha256=KVp6I1TbkePvfcG8ZMJ6OyNCG4QGBzk5a-7PN-DrkCo,740
+chatdeck/windows/bubble.ps1,sha256=3KU5xGk4Ndz8zJ7ET4ULrMzJXr6L7DMCtgK0jlNy8ZM,18033
+chatdeck/windows/focus_wt.ps1,sha256=5jg0slyKmKiRc98NI7L8iofbVxS1mpkmitbrc7OMLqk,4222
+chatdeck/windows/start.ps1,sha256=8fOiuPPnOEeKFw6H4jp6UA1vmgSDn0HSFO7PkZTfnuo,2052
+chatdeck-0.1.0.dist-info/licenses/LICENSE,sha256=MHNkmlUcd8LMZnGi58S4nAzCkH42kbjr2A0DxsLikWQ,1066
+chatdeck-0.1.0.dist-info/METADATA,sha256=Vuhp42c0KiBR0sTcgW9wdWgQoqT2QFh9hSixZ4ebO48,8709
+chatdeck-0.1.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+chatdeck-0.1.0.dist-info/entry_points.txt,sha256=b8jWrnNWd27e6Y8wookIN-9J1F4HWKp-GAUG46UudPo,47
+chatdeck-0.1.0.dist-info/top_level.txt,sha256=LnJ9TcoohY4YMngg38zawhZVxAO6QB_9d3VHGQhglaU,9
+chatdeck-0.1.0.dist-info/RECORD,,

chatdeck-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.2.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

chatdeck-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+chatdeck = chatdeck.cli:main

chatdeck-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Abdifatah
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

chatdeck-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+chatdeck