mirror of
https://github.com/Ark0N/Codeman.git
synced 2026-10-07 16:09:43 +02:00
docs: update documentation with new features
- Document long-running session support (12-24+ hours) - Document buffer management and limits - Document DELETE /api/sessions endpoint - Document resource monitoring and display - Document Kill All functionality - Document performance optimizations - Update feature list with new capabilities - Add Long-Running Sessions section to README Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
@@ -4,18 +4,20 @@ A Claude Code session manager with an autonomous Ralph Loop for task assignment
|
||||
|
||||
## Features
|
||||
|
||||
- **Web Interface**: Beautiful, responsive web UI with interactive terminal powered by xterm.js
|
||||
- **Session Management**: Spawn and manage multiple Claude CLI sessions as PTY subprocesses
|
||||
- **Interactive Terminal**: Full terminal access with resize support and buffer persistence for reconnections
|
||||
- **Web Interface**: Beautiful, responsive web UI with interactive terminal powered by xterm.js and modern gradient styling
|
||||
- **Session Management**: Spawn and manage multiple Claude CLI sessions as PTY subprocesses with one-click kill
|
||||
- **Interactive Terminal**: Full terminal access with resize support, buffer persistence, and 60fps batched rendering
|
||||
- **Respawn Controller**: Autonomous state machine that cycles sessions (update docs → /clear → /init) with configurable prompts
|
||||
- **Timed Runs**: Schedule Claude to work for a specific duration with live countdown
|
||||
- **Real-time Output**: Stream Claude's responses in real-time via Server-Sent Events (21 event types)
|
||||
- **Timed Runs**: Schedule Claude to work for a specific duration with animated live countdown
|
||||
- **Real-time Output**: Stream Claude's responses in real-time via Server-Sent Events (30 event types)
|
||||
- **Task Queue**: Priority-based task queue with dependency support
|
||||
- **Ralph Loop**: Autonomous control loop that assigns tasks to idle sessions and monitors completion
|
||||
- **Time-Aware Loops**: Extended work sessions with auto-generated follow-up tasks when minimum duration not reached
|
||||
- **Case Management**: Create project workspaces with auto-generated CLAUDE.md templates
|
||||
- **Cost Tracking**: Track total API costs across all sessions
|
||||
- **State Persistence**: All state persisted to `~/.claudeman/state.json`
|
||||
- **Long-Running Support**: Optimized for 12-24+ hour sessions with automatic buffer trimming
|
||||
- **Resource Monitoring**: Real-time memory/message usage display for each session
|
||||
|
||||
## Installation
|
||||
|
||||
@@ -37,14 +39,40 @@ claudeman web
|
||||
```
|
||||
|
||||
The web interface provides:
|
||||
- **Interactive Terminal**: Full xterm.js terminal with resize support
|
||||
- **Quick Start Button**: One-click to create a case and start an interactive Claude session
|
||||
- **Interactive Terminal**: Full xterm.js terminal with resize support and 60fps rendering
|
||||
- **Prompt Input**: Enter prompts and optionally set a working directory
|
||||
- **Duration Timer**: Set duration in minutes for timed runs (0 = single run)
|
||||
- **Live Output**: See Claude's response in real-time as it streams
|
||||
- **Countdown**: Large timer display when running timed jobs
|
||||
- **Session Monitoring**: View all active sessions with status indicators
|
||||
- **Countdown**: Animated timer display with shimmer progress bar
|
||||
- **Session Monitoring**: View all active sessions with status, resource usage, and cost
|
||||
- **Kill All Button**: One-click to terminate all running sessions and their child processes
|
||||
- **Resource Display**: Real-time memory usage and message count per session
|
||||
- **Respawn Controls**: Start/stop respawn controller with configurable settings
|
||||
- **Case Management**: Create new project workspaces with CLAUDE.md templates
|
||||
- **Modern UI**: Gradient backgrounds, smooth animations, and polished styling
|
||||
|
||||
#### Quick Start Button
|
||||
|
||||
The Quick Start feature reduces the typical 5-step workflow to just 1-2 steps:
|
||||
|
||||
**Before (5 steps):**
|
||||
1. Go to Cases tab
|
||||
2. Create a case
|
||||
3. Click the case
|
||||
4. Switch to Run tab
|
||||
5. Click Interactive
|
||||
|
||||
**After (1-2 steps):**
|
||||
1. (Optional) Select a case from dropdown
|
||||
2. Click "Quick Start"
|
||||
|
||||
The Quick Start button will:
|
||||
- Create a case folder in `~/claudeman-cases/` if it doesn't exist
|
||||
- Generate a CLAUDE.md file for the case
|
||||
- Create a new session pointed to that case directory
|
||||
- Start an interactive Claude terminal
|
||||
- Focus the terminal so you can start working immediately
|
||||
|
||||
### CLI Usage
|
||||
|
||||
@@ -227,6 +255,36 @@ When the minimum duration hasn't been reached and all tasks are complete, the Ra
|
||||
- Check for security vulnerabilities
|
||||
- Run linting and fix issues
|
||||
|
||||
## Long-Running Sessions
|
||||
|
||||
Claudeman is optimized for extended autonomous sessions (12-24+ hours):
|
||||
|
||||
### Buffer Management
|
||||
|
||||
To prevent memory issues during long runs, buffers are automatically managed:
|
||||
- **Terminal buffer**: Max 5MB, trims to 4MB when exceeded
|
||||
- **Text output**: Max 2MB, trims to 1.5MB when exceeded
|
||||
- **Messages**: Max 1000, keeps most recent 800 when exceeded
|
||||
|
||||
### Performance Optimizations
|
||||
|
||||
- **Server-side batching**: Terminal data batched at 60fps (16ms intervals)
|
||||
- **Client-side batching**: requestAnimationFrame for smooth rendering
|
||||
- **Aggressive process cleanup**: SIGKILL with process group termination
|
||||
|
||||
### Resource Monitoring
|
||||
|
||||
Each session displays real-time resource usage:
|
||||
- Memory usage (terminal + text buffers)
|
||||
- Message count
|
||||
- Color-coded warnings (green/yellow/red based on usage)
|
||||
|
||||
### Kill Sessions
|
||||
|
||||
- Click `✕` on individual session cards to terminate
|
||||
- Click `Kill All` button in sessions panel to terminate all at once
|
||||
- Sessions are forcefully killed with SIGKILL after SIGTERM timeout
|
||||
|
||||
## State File
|
||||
|
||||
All state is persisted to `~/.claudeman/state.json`:
|
||||
|
||||
Reference in New Issue
Block a user