BitSquare/Codeman
2
0
Fork 0
mirror of https://github.com/Ark0N/Codeman.git synced 2026-10-03 14:09:42 +02:00
Code Issues Packages Projects Releases Wiki Activity

docs: update README.md and CLAUDE.md with new features

Browse Source 
README.md:
- Add multi-tab sessions, monitor panel, session restoration to features
- Update keyboard shortcuts (remove Ctrl+N, update descriptions)
- Document new UI features in Additional Features section

CLAUDE.md:
- Add screen-manager.ts to architecture diagram
- Add ScreenManager to key components section
- Update WebServer description with session restoration
- Add completed tasks for recent features

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
arkon
2026-01-19 03:02:04 +01:00
co-authored by Claude Opus 4.5
parent 5b2091bd86
commit 7d01d3f274
2 changed files with 17 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files
CLAUDE.md
+9 -2
View File
@@ -30,6 +30,7 @@ src/
├── cli.ts # CLI command implementations
├── session.ts # Core: PTY wrapper for Claude CLI + token tracking
├── session-manager.ts # Manages multiple sessions
├── screen-manager.ts # GNU screen session persistence + process stats
├── respawn-controller.ts # Auto-respawn state machine
├── task-tracker.ts # Background task detection and tree display
├── ralph-loop.ts # Autonomous task assignment
@@ -37,7 +38,7 @@ src/
├── state-store.ts # Persistence to ~/.claudeman/state.json
├── types.ts # All TypeScript interfaces
├── web/
│ ├── server.ts # Fastify REST API + SSE
│ ├── server.ts # Fastify REST API + SSE + session restoration
│ └── public/ # Static frontend files
└── templates/
└── claude-md.ts # CLAUDE.md generator for new cases
@@ -60,7 +61,9 @@ src/
- **RalphLoop** (`src/ralph-loop.ts`): Autonomous task assignment controller. Monitors sessions for idle state, assigns tasks from queue, detects completion via `<promise>PHRASE</promise>` markers. Supports time-aware loops with minimum duration.
- **WebServer** (`src/web/server.ts`): Fastify server with REST API + SSE. Manages sessions, scheduled runs, respawn controllers, and case directories. Broadcasts all events to connected clients.
- **WebServer** (`src/web/server.ts`): Fastify server with REST API + SSE. Manages sessions, scheduled runs, respawn controllers, and case directories. Broadcasts all events to connected clients. Restores screen sessions on startup.
- **ScreenManager** (`src/screen-manager.ts`): Manages GNU screen sessions for persistent terminals. Tracks screens in `~/.claudeman/screens.json`. Provides process stats (memory, CPU, children) and reconciliation for dead screens. Screens survive server restarts.
### Type Definitions
@@ -347,3 +350,7 @@ The web UI (`src/web/public/`) uses vanilla JavaScript with:
- [x] Wrap each session in a GNU screen session - track in ~/.claudeman/screens.json with Process Monitor panel showing memory, CPU, children
- [x] UI cleanup: Move respawn controls to session options, remove mode label, fix directory display width
- [x] Fix terminal focus escape sequences: filter out ^[[I and ^[[O (focus in/out) ANSI codes
- [x] Merge Process Monitor and Background Tasks into single Monitor panel
- [x] Move font size controls (A+/A-) to header
- [x] Restore screen sessions automatically on server restart
- [x] Add multi-tab feature: number input (1-10) next to Run Claude to open multiple sessions at once
README.md
+8 -3
View File
@@ -23,6 +23,9 @@ A Claude Code session manager with an autonomous Ralph Loop for task assignment
- **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
- **Multi-Tab Sessions**: Open 1-10 Claude sessions at once for the same project
- **Session Restoration**: Automatically restore screen sessions when server restarts
- **Monitor Panel**: Combined view of screen sessions and background tasks
## Installation
@@ -86,8 +89,7 @@ The Quick Start button will:
| Shortcut | Action |
|----------|--------|
| `Ctrl+Enter` | Quick Start (create case + interactive session) |
| `Ctrl+N` | New Session |
| `Ctrl+Enter` | Run Claude (create case + interactive session) |
| `Ctrl+W` | Close current session |
| `Ctrl+Tab` | Switch to next session |
| `Ctrl+K` | Kill all sessions |
@@ -98,7 +100,10 @@ The Quick Start button will:
#### Additional Features
- **Terminal Font Controls**: Adjust font size with A+/A- buttons or Ctrl++/-
- **Multi-Tab Sessions**: Number input (1-10) next to "Run Claude" opens multiple sessions at once, named `1-projectname`, `2-projectname`, etc.
- **Monitor Panel**: Combined view of Screen Sessions and Background Tasks in one panel
- **Session Restoration**: Screen sessions are automatically restored when the server restarts
- **Terminal Font Controls**: Adjust font size with A+/A- buttons in header or Ctrl++/-
- **Copy Terminal Output**: Copy all terminal content to clipboard
- **Session Duration**: View how long each session has been running
- **Working Directory Display**: See the project folder for each session