claudedesk 4.4.0 → 4.4.1

package/.github/workflows/ci.yml

@@ -45,39 +45,8 @@ jobs:
         path: coverage/
         if-no-files-found: warn
 
-  e2e:
-    name: E2E Tests
-    needs: build
-    runs-on: ubuntu-latest
-
-    steps:
-    - uses: actions/checkout@v4
-
-    - name: Setup Node.js
-      uses: actions/setup-node@v4
-      with:
-        node-version: '20.x'
-        cache: 'npm'
-
-    - name: Install dependencies
-      run: npm ci
-
-    - name: Install Playwright
-      run: npx playwright install --with-deps chromium
-
-    - name: Build app
-      run: npm run build && npm run build:electron
-
-    - name: Run E2E tests
-      run: xvfb-run --auto-servernum npm run test:e2e
-
-    - name: Upload Playwright report
-      if: failure()
-      uses: actions/upload-artifact@v4
-      with:
-        name: playwright-report
-        path: playwright-report/
-        if-no-files-found: warn
+  # E2E tests require Electron + node-pty native module which can't launch in CI.
+  # Run locally with: npm run test:e2e
 
   package:
     name: Package Electron App

package/CHANGELOG.md

@@ -15,6 +15,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [4.4.1] - 2026-02-13
+
+### Fixed
+- **Burn rate calculation** — Now filters out samples from before quota resets; negative rates clamped to 0
+
+### Added
+- **Quota service tests** — Unit tests for `quota-service.ts` covering burn rate calculation, quota reset handling, and edge cases
+
+### Changed
+- **Documentation cleanup** — Removed deleted documentation files (agent teams guides, git integration specs, atlas evaluation, atlas UI prototype) and cleaned up dead references in CLAUDE.md and README.md
+
+---
+
 ## [4.3.1] - 2026-02-10
 
 ### Fixed
@@ -22,7 +35,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Updated `CLAUDE.md` to reflect simplified shell setup (cmd.exe on Windows, user shell on Unix)
   - Updated `SESSION_POOLING_IMPLEMENTATION.md` to remove directory locking references
   - Updated `CHANGELOG.md` to accurately describe current shell implementation
-  - Updated `docs/repo-index.md` and `docs/atlas-ui-prototype.html`
+  - Updated `docs/repo-index.md`
 
 ### Changed
 - **Shell implementation** - Simplified to use cmd.exe on Windows and user's default shell on Unix
@@ -190,7 +203,8 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on suggesting changes and
 
 ---
 
-[Unreleased]: https://github.com/carloluisito/claudedesk/compare/v4.3.1...HEAD
+[Unreleased]: https://github.com/carloluisito/claudedesk/compare/v4.4.1...HEAD
+[4.4.1]: https://github.com/carloluisito/claudedesk/compare/v4.3.1...v4.4.1
 [4.3.1]: https://github.com/carloluisito/claudedesk/compare/v4.3.0...v4.3.1
 [4.3.0]: https://github.com/carloluisito/claudedesk/compare/v4.1.1...v4.3.0
 [4.1.1]: https://github.com/carloluisito/claudedesk/compare/v4.1.0...v4.1.1

package/CLAUDE.md

@@ -122,7 +122,4 @@ Font: JetBrains Mono. Monospace everywhere.
 ## Docs
 
 - [Repo Index](docs/repo-index.md) — detailed domain-to-file mapping
-- [Agent Teams Guide](docs/AGENT_TEAMS.md)
-- [Quick Start: Agent Teams](docs/QUICKSTART_AGENT_TEAMS.md)
 - [Contributing](CONTRIBUTING.md)
-- [Repository Atlas Evaluation](docs/REPO_ATLAS_EVALUATION.md)

package/README.md

@@ -2,132 +2,153 @@
 
 ![License](https://img.shields.io/badge/license-MIT-blue.svg)
 ![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey.svg)
-![Version](https://img.shields.io/badge/version-4.3.0-green.svg)
+![Version](https://img.shields.io/badge/version-4.4.1-green.svg)
+![Tests](https://img.shields.io/badge/tests-233%20passing-brightgreen.svg)
 
 > A powerful desktop terminal for Claude Code CLI with multi-session management, split-view layouts, and advanced productivity features.
 
-**ClaudeDesk** is an Electron-based desktop application that wraps the Claude Code CLI in a feature-rich terminal interface. Manage multiple Claude sessions simultaneously, organize your workspace with split views, use prompt templates, and monitor your API usage—all in one beautiful desktop app.
+**ClaudeDesk** is an Electron-based desktop application that wraps the Claude Code CLI in a feature-rich terminal interface. Manage multiple Claude sessions simultaneously, organize your workspace with split views, use prompt templates, and monitor your API usage — all in one beautiful desktop app.
+
+![Main Screen](docs/main-screen.png)
 
 ---
 
-## 📸 Screenshots
+## Screenshots
+
+<table>
+<tr>
+<td width="50%">
+
+**Create Session** — Workspace-aware session creation with directory search and permission modes.
+
+![Create Session](docs/create-session.png)
+
+</td>
+<td width="50%">
+
+**Git Integration** — Built-in git panel with file staging, inline diffs, AI commit messages, and history.
+
+![Git Panel](docs/git-panel.png)
+
+</td>
+</tr>
+<tr>
+<td width="50%">
+
+**Workspace Layouts** — Choose from preset layouts or build a custom grid with up to 4 panes.
+
+![Workspace Layout](docs/work-space-layout.png)
+
+</td>
+<td width="50%">
+
+**Settings & Workspaces** — Configure workspaces, templates, drag-and-drop, atlas, and more.
+
+![Settings](docs/settings-workspace.png)
+
+</td>
+</tr>
+<tr>
+<td width="50%">
+
+**Fuel Status Popup** — Quick glance at API quota from the toolbar.
+
+![Fuel Popup](docs/fuel-status-popup.png)
+
+</td>
+<td width="50%">
 
-<!-- TODO: Add screenshots here -->
-<!-- Suggested screenshots:
-1. Main interface showing multi-session tabs
-2. Split-view with multiple terminal panes
-3. Command palette with prompt templates
-4. Settings dialog with quota monitoring
--->
+**Fuel Status Panel** — Detailed 5-hour and 7-day reserves with burn rate tracking.
 
-_Screenshots coming soon! For now, see [Features](#-features) for a detailed overview._
+![Fuel Panel](docs/fuel-status-side-panel.png)
+
+</td>
+</tr>
+</table>
 
 ---
 
-## ✨ Features
+## Features
 
 ### Multi-Session Management
 - **Multiple Claude sessions** in tabbed interface
-- **Session persistence** - resume sessions after app restart
+- **Session persistence** — resume sessions after app restart
 - **Named sessions** for better organization
-- **Session history** - search and export conversation logs
-- **Checkpoints** - save and restore session states
+- **Session history** — search and export conversation logs
+- **Checkpoints** — save and restore session states
 
 ### Split-View Terminal
 - **Split screen** support with up to 4 terminal panes
-- **Flexible layouts** - horizontal and vertical splits
+- **Flexible layouts** — horizontal, vertical, and grid splits
+- **Layout picker** — preset layouts (single, 2-column, 3-column, 2x2) or custom grids
 - **Drag-and-drop** session assignment to panes
-- **Independent sessions** per pane
 
-### Directory Locking
-- **Lock sessions** to their creation directory
-- **Prevents accidental directory changes** in Claude sessions
-- **Workspace support** - save favorite directories for quick access
-- **Per-session working directories**
+### Git Integration
+- **Full git workflow** — status, staging, branches, commit, push/pull/fetch, diff, log
+- **AI commit messages** — heuristic-based conventional commits generation
+- **Real-time file watching** — status updates automatically as you work
+- **Keyboard shortcut** `Ctrl+Shift+G` and staged count badge in toolbar
 
 ### Prompt Templates & Command Palette
 - **Keyboard shortcut** (`Ctrl/Cmd+Shift+P`) to launch command palette
 - **Prompt template library** for common tasks
-- **Variable substitution** - `{{clipboard}}`, `{{currentDir}}`, `{{selection}}`, etc.
-- **Custom templates** - create and edit your own
+- **Variable substitution** — `{{clipboard}}`, `{{currentDir}}`, `{{selection}}`, etc.
+- **Custom templates** — create and edit your own
 - **Fuzzy search** for quick template access
 
 ### API Quota Monitoring
-- **Real-time quota display** - see your Claude API usage at a glance
-- **Burn rate tracking** - monitor spending over time
-- **Budget alerts** - get notified when approaching limits
-- **Session-level tracking** (optional)
-
-### Terminal Features
-- **Full xterm.js terminal** with rich text formatting
-- **Clickable links** - URLs automatically detected
-- **Copy/paste support** with keyboard shortcuts
-- **Search** within terminal output
-- **Custom theme** - Tokyo Night inspired dark theme
-- **Monospace font** - JetBrains Mono for optimal readability
+- **Real-time quota display** — see your Claude API usage at a glance
+- **Burn rate tracking** — monitor spending over time
+- **Budget alerts** — get notified when approaching limits
+- **Fuel gauge** in toolbar with detailed popup and side panel
 
 ### Agent Teams
-- **Automatic team detection** - recursively monitors `~/.claude/teams/` directories for agent team activity
-- **Team Panel** - sidebar showing team hierarchy, members with color badges, and status
-- **Task Board** - Kanban-style visualization with per-team task directories
-- **Message Stream** - real-time inter-agent communication feed (parses `@agent>` messages, strips ANSI codes)
-- **Agent Graph** - interactive node-based relationship visualization
-- **Auto-layout** - automatically arranges panes when teammates join
-- **Lifecycle management** - stale teams auto-cleaned on startup; teams removed when sessions end
-- See [Agent Teams Guide](docs/AGENT_TEAMS.md) and [Quick Start](docs/QUICKSTART_AGENT_TEAMS.md)
-
-### Repository Atlas Engine
-- **Automated codebase mapping** - scans files, analyzes imports, infers domain boundaries
-- **CLAUDE.md generation** - creates architectural atlas for AI tools to navigate the repo
-- **Domain-to-file index** - generates `docs/repo-index.md` with per-domain file tables
-- **Inline entrypoint tags** - suggests `@atlas-entrypoint` comments for key files
-- **Preview and approve** - review generated content before writing to disk
-- **Configurable settings** - domain sensitivity, max inline tags, exclude patterns
-
-### Session Control
-- **Permission modes** - control Claude's access level per session
-- **Ctrl+C handling** - graceful session termination with confirmation
-- **Session export** - save conversations to markdown
-- **Session search** - find past conversations
-
----
+- **Automatic team detection** — monitors `~/.claude/teams/` for agent team activity
+- **Team Panel** — sidebar showing team hierarchy, members, and status
+- **Task Board** — Kanban-style visualization with per-team tasks
+- **Message Stream** — real-time inter-agent communication feed
+- **Agent Graph** — interactive node-based relationship visualization
+- **Auto-layout** — automatically arranges panes when teammates join
 
-## 🚀 Why ClaudeDesk?
 
-While Claude Code CLI is powerful, managing multiple sessions, switching contexts, and organizing prompts becomes unwieldy in a terminal. ClaudeDesk solves this by adding:
+### Repository Atlas Engine
+- **Automated codebase mapping** — scans files, analyzes imports, infers domain boundaries
+- **CLAUDE.md generation** — creates architectural atlas for AI tools to navigate the repo
+- **Domain-to-file index** — generates `docs/repo-index.md` with per-domain file tables
+- **Preview and approve** — review generated content before writing to disk
 
-✅ **Multi-session management** - Run multiple Claude conversations in tabs
-✅ **Directory locking** - Each session stays in its project directory
-✅ **Prompt library** - Reusable templates for common tasks
-✅ **Quota monitoring** - See your API usage at a glance
-✅ **Split view** - Work on multiple projects side-by-side
-✅ **Persistent state** - Never lose your session history
+### Terminal Features
+- **Full xterm.js terminal** with rich text formatting
+- **Clickable links** — URLs automatically detected
+- **Copy/paste support** with keyboard shortcuts
+- **Tokyo Night dark theme** with JetBrains Mono font
+- **Drag-and-drop** file insertion into terminal
 
 ---
 
-## 📋 Prerequisites
+## Prerequisites
 
 Before installing ClaudeDesk, ensure you have:
 
-1. **Node.js 18+** - [Download here](https://nodejs.org/)
-2. **Claude Code CLI** - Install via:
+1. **Node.js 20+** — [Download here](https://nodejs.org/)
+2. **Claude Code CLI** — Install via:
    ```bash
    npm install -g @anthropic-ai/claude-code
    ```
    Or follow the [official installation guide](https://claude.ai/claude-code)
-3. **Claude API credentials** - ClaudeDesk reads from `~/.claude/.credentials.json` (set up by Claude CLI)
+3. **Claude API credentials** — ClaudeDesk reads from `~/.claude/.credentials.json` (set up by Claude CLI)
 
 ---
 
-## 💻 Installation
+## Installation
 
 ### Option 1: Download Pre-built Binary (Recommended)
 
-**Coming soon!** Download the latest release for your platform from the [Releases](https://github.com/carloluisito/claudedesk/releases) page.
+Download the latest release for your platform from the [Releases](https://github.com/carloluisito/claudedesk/releases) page.
 
-- **Windows**: `ClaudeDesk-Setup-1.0.0.exe`
-- **macOS**: `ClaudeDesk-1.0.0.dmg`
-- **Linux**: `ClaudeDesk-1.0.0.AppImage` or `.deb`
+- **Windows**: `.exe` installer
+- **macOS**: `.dmg`
+- **Linux**: `.AppImage` or `.deb`
 
 ### Option 2: Build from Source
 
@@ -140,7 +161,7 @@ cd claudedesk
 npm install
 
 # Run in development mode
-npm run electron:dev
+npm run electron:watch
 
 # Or build for production
 npm run package
@@ -157,180 +178,111 @@ Built packages will be in the `release/` directory.
 
 ---
 
-## 🎯 Quick Start
-
-1. **Launch ClaudeDesk** from your applications menu or run `npm run electron:dev`
-
-2. **Create your first session:**
-   - Click "New Session" or press `Ctrl/Cmd+N`
-   - Name your session (e.g., "My Project")
-   - Select working directory
-   - Choose permission mode (Ask, Auto-approve, or Auto-deny)
-
-3. **Start using Claude:**
-   - Type your prompt in the terminal
-   - Claude responds just like the CLI
-   - Your session is automatically saved
+## Quick Start
 
-4. **Try the command palette:**
-   - Press `Ctrl/Cmd+Shift+P`
-   - Browse or search prompt templates
-   - Select a template to insert it
-
-5. **Enable split view:**
-   - Click the split view icon in the header
-   - Create multiple panes for parallel work
-   - Drag sessions between panes
+1. **Launch ClaudeDesk** from your applications menu or run `npm run electron:watch`
+2. **Create your first session** — click "+" or press `Ctrl+T`, pick a workspace and directory
+3. **Start using Claude** — type your prompt in the terminal
+4. **Try the command palette** — press `Ctrl+Shift+P` to browse prompt templates
+5. **Enable split view** — use the layout picker or click split controls in the pane header
 
 ---
 
-## 🎨 Key Keyboard Shortcuts
+## Keyboard Shortcuts
 
 | Shortcut | Action |
 |----------|--------|
-| `Ctrl/Cmd+N` | New Session |
-| `Ctrl/Cmd+W` | Close Current Session |
-| `Ctrl/Cmd+Tab` | Next Session Tab |
-| `Ctrl/Cmd+Shift+Tab` | Previous Session Tab |
-| `Ctrl/Cmd+Shift+P` | Open Command Palette |
-| `Ctrl/Cmd+F` | Search in Terminal |
-| `Ctrl/Cmd+,` | Open Settings |
+| `Ctrl+T` | New Session |
+| `Ctrl+W` | Close Current Session |
+| `Ctrl+Tab` | Next Session Tab |
+| `Ctrl+Shift+Tab` | Previous Session Tab |
+| `Ctrl+Shift+P` | Open Command Palette |
+| `Ctrl+Shift+G` | Open Git Panel |
+| `Ctrl+,` | Open Settings |
 | `Ctrl+C` | Session Termination Dialog |
 
 ---
 
-## 🔒 Privacy & Security
-
-ClaudeDesk is designed with privacy in mind:
-
-- **Local-first**: All session data stored on your machine
-- **No telemetry**: We don't collect or transmit usage data
-- **No third-party services**: Only communicates with Anthropic's official API
-- **Credential security**: Reads Claude CLI credentials locally, never logs or stores them
-- **HTTPS only**: All API calls use secure connections
-
-### Credentials Handling
+## Tech Stack
 
-ClaudeDesk reads Claude Code CLI credentials from `~/.claude/.credentials.json` to:
-- Display API quota usage
-- Monitor burn rate
-- Provide session management features
-
-**Your credentials are:**
-- ✅ Read locally only
-- ✅ Never logged or stored by ClaudeDesk
-- ✅ Only sent to Anthropic's official API endpoints (api.anthropic.com)
-- ✅ Transmitted over HTTPS
-
-You can disable quota monitoring in Settings if you prefer.
-
-For more details, see [SECURITY.md](SECURITY.md).
+| Layer | Technology |
+|-------|-----------|
+| Framework | Electron 28 |
+| Frontend | React 18 + TypeScript |
+| Terminal | xterm.js + node-pty |
+| Styling | Tailwind CSS (Tokyo Night theme) |
+| Graph | reactflow |
+| Build | Vite + electron-builder |
+| Testing | Vitest 4 (233 tests) + Playwright |
 
 ---
 
-## 🗂️ Project Structure
+## Project Structure
 
 ```
 claudedesk/
 ├── src/
-│   ├── main/              # Electron main process
-│   │   ├── index.ts       # App entry point
-│   │   ├── cli-manager.ts # PTY spawning & Claude CLI lifecycle
-│   │   ├── session-manager.ts
-│   │   ├── ipc-handlers.ts   # Handler implementations (uses IPCRegistry)
-│   │   ├── ipc-registry.ts   # Typed handler registration + auto-cleanup
-│   │   ├── ipc-emitter.ts    # Type-safe main→renderer push events
-│   │   └── quota-service.ts
-│   ├── preload/           # Context bridge (auto-generated from contract)
-│   │   └── index.ts
-│   ├── renderer/          # React app (UI)
-│   │   ├── App.tsx
-│   │   ├── components/
-│   │   ├── hooks/
-│   │   └── utils/
-│   └── shared/            # Shared types & IPC contract
-│       ├── ipc-contract.ts   # Single source of truth for all IPC methods
-│       └── ipc-types.ts      # Data type definitions
-├── resources/             # Icons and assets
-├── dist/                  # Build output
-└── release/               # Packaged apps
+│   ├── main/              # Electron main process (9 managers)
+│   ├── preload/           # Context bridge (auto-derived from contract)
+│   ├── renderer/          # React app (hooks, components, utils)
+│   └── shared/            # IPC contract, types, shared utilities
+├── test/                  # Test setup and helpers
+├── e2e/                   # Playwright E2E tests
+├── docs/                  # Documentation and screenshots
+└── .github/workflows/     # CI pipeline
 ```
 
----
+See [docs/repo-index.md](docs/repo-index.md) for a detailed domain-to-file mapping.
 
-## 🛠️ Development
+---
 
-### Setup Development Environment
+## Development
 
 ```bash
-# Install dependencies
-npm install
-
-# Run in development mode (hot reload)
-npm run electron:dev
-
-# Run tests (when available)
-npm test
-
-# Lint code
-npm run lint
+npm install              # Install dependencies
+npm run electron:watch   # Dev mode with hot reload
+npm test                 # Run all 233 tests
+npm run test:watch       # Watch mode
+npm run test:e2e         # E2E tests (local only)
+npm run test:coverage    # Coverage report
 ```
 
-### Tech Stack
-
-- **Framework**: Electron 28
-- **Frontend**: React 18 + TypeScript
-- **Terminal**: xterm.js with fit and web-links addons
-- **PTY**: node-pty for cross-platform shell spawning
-- **Styling**: Tailwind CSS (Tokyo Night theme)
-- **Build**: Vite + electron-builder
-
-### Contributing
-
-We welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on:
-- Development setup
-- Code style and standards
-- How to submit pull requests
-- Issue reporting
+See [CONTRIBUTING.md](CONTRIBUTING.md) for development guidelines.
 
 ---
 
-## 🐛 Known Issues
-
-### Development Dependency Vulnerabilities
-
-Some development dependencies (electron, vite, electron-builder) have known security advisories. These affect development and build processes only—**not the distributed application**. See [SECURITY.md](SECURITY.md#known-issues) for details.
+## Privacy & Security
 
-### Platform-Specific Notes
+- **Local-first** — all session data stored on your machine
+- **No telemetry** — no usage data collected or transmitted
+- **No third-party services** — only communicates with Anthropic's official API
+- **Credential security** — reads Claude CLI credentials locally, never logs or stores them
 
-- **Windows**: PowerShell is used as the default shell. Ensure `claude` is in your PATH.
-- **macOS**: Requires macOS 10.13+ (High Sierra or later).
-- **Linux**: Tested on Ubuntu 20.04+. May require `libxtst6` and `libnss3` packages.
+For more details, see [SECURITY.md](SECURITY.md).
 
 ---
 
-## 📝 Changelog
+## Known Issues
 
-See [CHANGELOG.md](CHANGELOG.md) for version history and release notes.
+- **Windows**: `cmd.exe` is used as the default shell. Ensure `claude` is in your PATH.
+- **macOS**: Requires macOS 10.13+ (High Sierra or later).
+- **Linux**: May require `libxtst6` and `libnss3` packages.
 
 ---
 
-## 🤝 Contributing
-
-Contributions are welcome! Here's how you can help:
+## Contributing
 
-1. **Report bugs** - [Open an issue](https://github.com/carloluisito/claudedesk/issues/new?template=bug_report.md)
-2. **Suggest features** - [Request a feature](https://github.com/carloluisito/claudedesk/issues/new?template=feature_request.md)
-3. **Submit PRs** - See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines
-4. **Improve docs** - Help make the documentation better
+1. **Report bugs** — [Open an issue](https://github.com/carloluisito/claudedesk/issues/new?template=bug_report.md)
+2. **Suggest features** — [Request a feature](https://github.com/carloluisito/claudedesk/issues/new?template=feature_request.md)
+3. **Submit PRs** — See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines
 
 Please read our [Code of Conduct](CODE_OF_CONDUCT.md) before contributing.
 
 ---
 
-## 📄 License
+## License
 
-This project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.
+This project is licensed under the **MIT License** — see the [LICENSE](LICENSE) file for details.
 
 ```
 Copyright (c) 2026 Carlo Luisito Adap
@@ -338,16 +290,7 @@ Copyright (c) 2026 Carlo Luisito Adap
 
 ---
 
-## 🙏 Acknowledgments
-
-- **Anthropic** for creating Claude and Claude Code CLI
-- **xterm.js** for the excellent terminal emulation library
-- **Electron** for making desktop apps easy
-- **node-pty** for cross-platform PTY support
-
----
-
-## ⚠️ Disclaimer
+## Disclaimer
 
 **ClaudeDesk is an unofficial community project and is not endorsed, affiliated with, or supported by Anthropic.**
 
@@ -355,7 +298,7 @@ This is an independent wrapper around the Claude Code CLI. For official support,
 
 ---
 
-## 📧 Support
+## Support
 
 - **Issues**: [GitHub Issues](https://github.com/carloluisito/claudedesk/issues)
 - **Security**: See [SECURITY.md](SECURITY.md) for reporting vulnerabilities
@@ -363,12 +306,6 @@ This is an independent wrapper around the Claude Code CLI. For official support,
 
 ---
 
-## 🌟 Star this repo!
-
-If you find ClaudeDesk useful, please consider starring the repository to help others discover it!
-
 [![GitHub stars](https://img.shields.io/github/stars/carloluisito/claudedesk?style=social)](https://github.com/carloluisito/claudedesk/stargazers)
 
----
-
-**Made with ❤️ by [Carlo Luisito Adap](https://github.com/carloluisito)**
+**Made with love by [Carlo Luisito Adap](https://github.com/carloluisito)**