New GitChain Session

New GitChain Session

Spin up an isolated Claude Code session with web terminal access, auto-git-logging, and screenshot capture.

Process

1. Parse $ARGUMENTS for:
   • Project name (what to work on)
   • Port (optional, auto-assigned from 7700-7799)
   • Task description (what Claude Code should start doing)
2. SSH to REACTOR and run the session launcher
3. Wait for ttyd to be ready (~3-5 seconds)
4. Return the web terminal URL

What Gets Created

Docker Container: gitchain-{session-id}
├── ttyd → Web terminal on port {port}
├── tmux → Persistent terminal session
├── Claude Code → Pre-authenticated, ready to work
├── Git repo → Cloned from shared bare repo
└── GitChain Logger → Auto-commits every 10s
    ├── Code changes → structured git commits
    ├── Screenshots → auto-committed when captured
    └── Terminal log → full session recording

Output Format

# ⛓ GitChain Session Created

| Field | Value |
|-------|-------|
| Session ID | s-{id} |
| Terminal | http://192.168.145.10:{port} |
| Project | {project} |
| Container | {container_id} |
| Status | ✅ Ready |

## Quick Access
- **Open Terminal:** [http://192.168.145.10:{port}](http://192.168.145.10:{port})
- **Git Branch:** session/{session-id}
- **Logs:** docker logs gitchain-s-{id}

## What's Running
- ttyd web terminal (writable, 5 max clients)
- Claude Code (pre-authenticated)
- GitChain logger (auto-commit every 10s)
- Screenshot watcher (auto-commit captures)

💡 Tell Chrome-Claude to navigate to the terminal URL to start.

Rules

• Always verify the container started successfully
• Always return the terminal URL prominently
• Session ports: 7700-7799
• One container per session, fully isolated
• Git commits are structured with metadata (timestamp, action type, files)