agent-portal
Health Warn
- No license — Repository has no license file
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Community trust — 16 GitHub stars
Code Fail
- rm -rf — Recursive force deletion command in .github/actions/setup-rust/action.yml
Permissions Pass
- Permissions — No dangerous permissions requested
No AI report is available for this listing yet.
Elegant web interface for claude or codex development.
Claude Code Portal — Try It: txcl.io
A web portal that extends Claude Code with session sharing, remote access, and collaborative features. Run Claude Code on powerful machines and access it from anywhere through your browser.
Features
- Remote Access: Run Claude Code on dedicated machines, access from any browser
- Session Sharing: Share sessions with team members for collaborative coding
- Voice Input: Dictate commands using the browser's built-in Web Speech API (Chrome, Edge, Safari)
- Persistent History: All conversations stored and accessible across devices
- Flexible Authentication: Configure for single-user, organization-only, or public access
- Real-time Sync: Multiple viewers see updates instantly via WebSocket
- VS Code Integration: Use Claude Code in VS Code while sessions appear on the portal dashboard
Use Cases
- Hardware Development: Develop against specialized hardware (GPUs, FPGAs, embedded devices) from any laptop
- Powerful Workstations: Run Claude Code on beefy machines while traveling with a thin client
- Mobile Development: Code from your phone or tablet - the web UI works on any device
- Team Collaboration: Share Claude sessions for pair programming or code review
- Long-Running Tasks: Start a task, walk away, check results later from any device
- Consistent Environment: Keep your dev environment on one machine, access it everywhere
Quick Start
# Clone the repository
git clone https://github.com/meawoppl/agent-portal.git
cd agent-portal
# Start everything (auto-installs dependencies)
./scripts/dev.sh start
Then open: http://localhost:3000/
You'll be automatically logged in as [email protected] in dev mode.
See Local Development for more details on the dev script and available commands.
Architecture
flowchart TB
subgraph dev["Dev Machine"]
subgraph portal["claude-portal binary"]
subgraph codes["claude-codes crate"]
claude["claude CLI binary"]
end
end
end
subgraph server["Backend Server"]
axum["Axum Web Server"]
db[(PostgreSQL)]
axum <--> db
end
subgraph browser["Web Browser"]
yew["Yew WASM Frontend"]
end
portal <-->|"WebSocket"| axum
yew <-->|"WebSocket"| axum
axum -->|"Serves"| yew
The portal refers to the complete system: backend server, web frontend, and CLI binary. The CLI binary (claude-portal) connects your local Claude Code instance to the portal server, enabling remote access and session sharing.
Components
| Component | Description |
|---|---|
| Backend | Axum web server with PostgreSQL, OAuth, WebSocket coordination |
| Frontend | Yew WebAssembly app with terminal-style UI and voice input |
| CLI | claude-portal binary that wraps Claude Code and connects to backend |
| Shared | Common types and protocol definitions (WASM-compatible) |
Documentation
| Document | Description |
|---|---|
| Usage Guide | Web interface, CLI options, voice input, session sharing |
| Local Development | Quick setup with dev.sh, available commands |
| Development Guide | Full dev workflow, building, testing, contributing |
| Architecture Vocabulary | Runtime components, core concepts, and message flow terminology |
| Deployment Guide | Production deployment, Google OAuth setup, configuration |
| Docker Guide | Docker and Kubernetes deployment with 1Password |
| VS Code Setup | Use Claude Code in VS Code with portal integration |
| Troubleshooting | Common issues and solutions |
Platform Support
| Platform | Status |
|---|---|
| Linux (x86_64) | Tested |
| Linux (aarch64) | Builds in CI |
| macOS (Apple Silicon) | Builds in CI |
| macOS (Intel) | Builds in CI |
| Windows (x86_64) | Builds in CI |
Pre-built binaries available from GitHub Releases.
Technologies
- Backend: Axum 0.7, Diesel 2.2, Tokio
- Frontend: Yew 0.21, WebAssembly
- Claude Integration: claude-codes
- Voice: Web Speech API
Contributing
Contributions are welcome! Please:
- Fork the repository
- Create a feature branch
- Run
cargo testandcargo clippy - Submit a pull request
Please open an issue first to discuss major changes.
Security & Privacy
When using the hosted instance at txcl.io, please be aware:
- Data Access: The txcl.io server can access your Claude Code session content
- Data Storage: Session messages are stored temporarily on our servers for history display purposes only
- Retention: Message data is retained for a limited time and then automatically deleted
- Purpose: Messages are stored solely to enable the web interface history feature
- No Analysis: We do not analyze, share, or use your session content for any other purpose
- User Control: You can delete your sessions and associated data at any time from the dashboard
For complete data control, you can self-host your own instance of Claude Code Portal. See Deployment Guide for instructions.
License
MIT License - see LICENSE file for details
Support
- Issues: GitHub Issues
- Discussions: GitHub Discussions
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found