Container Use Web (cuweb)

A CLI tool (cuweb) for running a local web UI for monitoring and managing Container Use environments.

• 🌐 Web UI
• 🚀 Container Use Environment Monitoring
• 🔄 Git Integration
• 📁 File Explorer
• ⚡ Terminal Access
• 📊 Log/Diff Monitoring

Installation

Global Installation

npm install -g cuweb

Development Installation

Prerequisites: Make sure you have pnpm installed:

npm install -g pnpm

Build and link:

git clone https://github.com/b1tank/container-use-web.git
cd container-use-web

./scripts/build.sh
npm link

The build script will automatically install all dependencies and build the CLI, frontend, and backend.

Usage

Command Options

• -h, --host <HOST> - Host to listen on (default: localhost)
• -p, --port <PORT> - Port to listen on (default: 8000)
• -d, --dir <DIR> - Working directory (default: . - current directory)
• -b, --bin <BINARY> - Path to the container-use binary (default: container-use)
• -n, --no-open - Do not automatically open the browser (browser opened by default)
• -V, --version - Show version information
• -H, --help - Show help message

Examples

# Start from current directory
cuweb

# Start from home directory
cuweb --dir ~

# Start from a specific directory
cuweb --dir ~/projects/my-app

# Start on different port and host
cuweb --host 0.0.0.0 --port 8080

# Use specific container-use binary
cuweb --bin ./my-container-use --dir .

The UI will automatically open in your browser with the specified working directory and binary path configured.

Contributing

Project Structure

container-use-web/
├── src/              # CLI source code
├── backend/          # Hono API server
├── frontend/         # React UI
└── scripts/          # Build and utility scripts

License

MIT