AI Docker CLI Manager

Run AI tools securely in an isolated Docker container

 

Quick Start • Features • User Manual • Contributing • Report Bug

---

📥 Download

Windows (Recommended) ⬇️ Download AI_Docker_Manager.exe Note: Windows SmartScreen may show a warning because the app isn't code-signed. Click "More info" → "Run anyway" to proceed. Why does this happen?

Requirements Windows 10/11 (64-bit) Docker Desktop 4GB RAM (8GB recommended) 10GB free disk space

---

✨ Features

Feature	Description
🤖 Multiple AI Tools	Claude, GitHub CLI, OpenAI/GPT, Gemini, Codex, and more
🎯 Vibe Kanban	Orchestrate multiple AI agents in parallel via web UI
📱 Mobile Access	Access Claude from your phone via SSH + Mosh (optional)
🔒 Secure Isolation	AI runs in Docker container - can't access your system files
🚀 One-Click Setup	Interactive wizard handles everything automatically
🔄 Auto-Updates	CLI tools update automatically every week
📁 Easy File Access	Your AI_Work folder is accessible from Windows
🎨 Modern UI	Matrix-themed interface with live progress feedback

Included AI CLI Tools

• Claude Code - Anthropic's AI coding assistant
• Vibe Kanban - Web UI to orchestrate AI agents in parallel (⚠️ runs with elevated permissions)
• GitHub CLI - GitHub's official command-line tool
• OpenAI Codex CLI - OpenAI's coding assistant
• OpenAI SDK - Python SDK for OpenAI API
• Google Gemini - Google's AI assistant

---

🚀 Quick Start

Installation (5-10 minutes)

1. Download AI_Docker_Manager.exe from the link above
2. Run the executable
3. Click "First Time Setup"
4. Follow the wizard:
   • Enter username/password for container
   • Select location for your AI_Work folder
   • Wait for Docker build and tool installation

Daily Use (10 seconds)

1. Run AI_Docker_Manager.exe
2. Choose your interface:
   • "Launch AI Workspace" - Terminal access to all AI tools
   • "Launch Vibe Kanban" - Web UI for parallel AI agents
3. Start working - all AI tools are ready!

# Inside the container (terminal mode)
cd /workspace/my-project
claude                    # Start Claude Code
gh repo clone user/repo   # Use GitHub CLI
codex "explain this code"  # Use OpenAI Codex

Vibe Kanban Note: Opens at http://localhost:3000. Runs agents with elevated permissions - always review changes before committing.

---

📚 Documentation

Document	Description
User Manual	Complete guide for end users
CLI Tools Guide	Reference for all AI tools
Quick Reference	One-page cheatsheet
Remote Access	Mobile phone access via SSH/Mosh
Troubleshooting	Logging and debugging guide
Migration Guide	Upgrading between versions
Development Guide	For contributors

---

⬆️ Upgrading

From v1.1.x to v1.2.x

Run "First Time Setup" with Force Rebuild checked to pick up the latest scripts.

v1.2.2+: Credentials now persist across rebuilds — no re-authentication needed.

From v1.0.x to v1.1.x

Breaking change: Claude Code has been migrated from npm to the native installer.

Existing users must:

1. Run "First Time Setup" with Force Rebuild checked
2. Re-authenticate all tools (one-time only — v1.2.2+ persists credentials across future rebuilds)

Your Claude conversation history will be preserved. See the Migration Guide for details.

---

🛡️ Security

AI Docker CLI Manager keeps your system safe:

• Isolated Environment - AI only sees files in your AI_Work folder
• Container Sandboxing - Runs in a separate Linux environment
• User Permissions - AI runs as a non-root user
• No Internet Backdoors - Only accesses AI APIs you configure

---

❓ FAQ

Windows SmartScreen Warning

When you run the .exe, Windows may show:

"Windows protected your PC - Microsoft Defender SmartScreen prevented an unrecognized app from starting"

This is normal for unsigned apps. To proceed:

1. Click "More info"
2. Click "Run anyway"

The app is open-source - you can review the code or build from source.

"Docker is not running"

The app will try to start Docker Desktop automatically. If it fails:

1. Open Docker Desktop manually
2. Wait for it to fully start (green icon in system tray)
3. Try again

Container Issues

# View container logs
docker logs ai-cli

# Restart container
docker restart ai-cli

# Full rebuild
docker stop ai-cli && docker rm ai-cli && docker rmi docker-files-ai
# Then run "First Time Setup" again

Where are my files?

• Workspace: The folder you selected during setup (e.g., C:\Users\You\Documents\AI_Work)
• App Config: %LOCALAPPDATA%\AI-Docker-CLI\
• Logs: %LOCALAPPDATA%\AI-Docker-CLI\logs\ai-docker.log

---

🔧 Advanced Usage

Mobile Access (SSH + Mosh)

Access Claude Code from your phone with seamless network roaming:

# 1. Enable in .env file (in %LOCALAPPDATA%\AI-Docker-CLI\)
ENABLE_MOBILE_ACCESS=1

# 2. Rebuild container

# 3. Add your SSH public key to the container
docker exec ai-cli bash -c 'echo "YOUR_PUBLIC_KEY" >> ~/.ssh/authorized_keys'

# 4. Connect from mobile (via VPN like Tailscale)
mosh --ssh="ssh -p 2222" username@docker-host-ip

# 5. Start tmux for scrollback
tmux new -s mobile

See Remote Access Guide for complete setup instructions.

DEV Mode (UI Testing)

Hold Shift while clicking "First Time Setup" to enter DEV mode - walks through the UI without making changes.

Manual Container Management

docker ps -a --filter "name=ai-cli"  # Check status
docker start ai-cli                   # Start
docker stop ai-cli                    # Stop
docker exec -it ai-cli bash           # Shell access

Building from Source

# Install ps2exe module
Install-Module -Name ps2exe -Force

# Build the executable
Invoke-ps2exe -inputFile "scripts/AI_Docker_Complete.ps1" -outputFile "AI_Docker_Manager.exe" -noConsole

---

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

• 🐛 Report a bug
• 💡 Request a feature
• 📖 Improve documentation

---

📄 License

This project is licensed under the MIT License.

Logo: Based on Tabler Icons (MIT License)

---

🙏 Acknowledgments

• Claude Code CLI by Anthropic
• Docker
• Tabler Icons for the logo

---

_{Built with ❤️ for secure AI development}