{"id":29985809,"url":"https://github.com/ifokeev/codetunnel","last_synced_at":"2026-05-16T22:05:23.350Z","repository":{"id":306783997,"uuid":"1025763875","full_name":"ifokeev/codetunnel","owner":"ifokeev","description":"CodeTunnel - AI-Powered Development from Anywhere","archived":false,"fork":false,"pushed_at":"2025-07-27T15:26:52.000Z","size":62863,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-05T00:47:37.968Z","etag":null,"topics":["claude","cloudflare","codex","gemini-cli","ttyd","web-terminal"],"latest_commit_sha":null,"homepage":"https://ifokeev.github.io/codetunnel/","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ifokeev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-24T19:02:00.000Z","updated_at":"2025-08-05T00:05:03.000Z","dependencies_parsed_at":"2025-07-27T16:46:16.948Z","dependency_job_id":"a4ca2eef-cbc5-49ed-bbfa-4c016fb7612d","html_url":"https://github.com/ifokeev/codetunnel","commit_stats":null,"previous_names":["ifokeev/codetunnel"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/ifokeev/codetunnel","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ifokeev%2Fcodetunnel","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ifokeev%2Fcodetunnel/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ifokeev%2Fcodetunnel/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ifokeev%2Fcodetunnel/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ifokeev","download_url":"https://codeload.github.com/ifokeev/codetunnel/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ifokeev%2Fcodetunnel/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33120450,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-16T18:38:32.183Z","status":"ssl_error","status_checked_at":"2026-05-16T18:38:29.903Z","response_time":115,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["claude","cloudflare","codex","gemini-cli","ttyd","web-terminal"],"created_at":"2025-08-04T22:01:56.958Z","updated_at":"2026-05-16T22:05:23.344Z","avatar_url":"https://github.com/ifokeev.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# CodeTunnel\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"apps/desktop/src/assets/logo-no-text.svg\" alt=\"CodeTunnel Logo\" width=\"128\" height=\"128\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eInstant, secure development tunnels for web terminals\u003c/strong\u003e\u003cbr\u003e\n  \u003cem\u003ePerfect for AI-assisted coding from anywhere 🌴\u003c/em\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/ifokeev/codetunnel/releases/latest\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/v/release/ifokeev/codetunnel?style=flat-square\" alt=\"Latest Release\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/ifokeev/codetunnel/blob/main/LICENSE\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/license/ifokeev/codetunnel?style=flat-square\" alt=\"License\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/ifokeev/codetunnel/actions\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/actions/workflow/status/ifokeev/codetunnel/build.yml?style=flat-square\" alt=\"Build Status\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://ifokeev.github.io/codetunnel/\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/website-live-brightgreen?style=flat-square\" alt=\"Website\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"#features\"\u003eFeatures\u003c/a\u003e •\n  \u003ca href=\"#installation\"\u003eInstallation\u003c/a\u003e •\n  \u003ca href=\"#usage\"\u003eUsage\u003c/a\u003e •\n  \u003ca href=\"#building\"\u003eBuilding\u003c/a\u003e •\n  \u003ca href=\"#security\"\u003eSecurity\u003c/a\u003e •\n  \u003ca href=\"#contributing\"\u003eContributing\u003c/a\u003e\n\u003c/p\u003e\n\n## Overview\n\nCodeTunnel is a cross-platform desktop application that provides instant, secure web-based terminal access for developers. Built with Tauri 2.0, it bundles [ttyd](https://github.com/tsl0922/ttyd) and [cloudflared](https://github.com/cloudflare/cloudflared) to create secure development tunnels that make your local terminal accessible from anywhere.\n\n## Features\n\n- 🌴 **Hawaiian-Themed UI** - Beautiful tropical design with palm tree branding\n- 🚀 **Instant Terminal Access** - Launch a web terminal in seconds\n- 🌐 **Secure Tunnels** - Powered by Cloudflare's global network\n- 🔒 **URL-based Security** - Each session protected by a unique 32-character token\n- 📱 **Mobile Friendly** - Works perfectly with AI coding assistants on iPad/mobile\n- 💻 **Cross-Platform** - Native apps for macOS, Windows, and Linux\n- 🤖 **AI Development Ready** - Optimized for Claude Code, Gemini CLI, and other AI tools\n- ⚡ **Lightning Fast** - Minimal latency with Rust backend\n\n## Installation\n\n### Download Pre-built Binaries\n\nVisit our [website](https://ifokeev.github.io/codetunnel/) or [GitHub Releases](https://github.com/ifokeev/codetunnel/releases) to download:\n\n#### macOS\n- Download: `CodeTunnel_x.x.x_universal.dmg` (Intel \u0026 Apple Silicon)\n- First run: Right-click and select \"Open\" to bypass Gatekeeper\n- Or remove quarantine: `xattr -cr /Applications/CodeTunnel.app`\n\n#### Windows\n- Download: `CodeTunnel_x.x.x_x64-setup.exe` or `.msi`\n- Run installer and follow the wizard\n- First run: Click \"More info\" → \"Run anyway\" if SmartScreen appears\n\n#### Linux\n- **AppImage** (recommended): `CodeTunnel_x.x.x_amd64.AppImage`\n  ```bash\n  chmod +x CodeTunnel_*.AppImage\n  ./CodeTunnel_*.AppImage\n  ```\n- **Debian/Ubuntu**: `codetunnel_x.x.x_amd64.deb`\n  ```bash\n  sudo dpkg -i codetunnel_*.deb\n  ```\n\n### Install from Source\n\nSee the [Building](#building) section below.\n\n## Usage\n\n1. **Launch CodeTunnel** - Open the application\n2. **Start Terminal** - Click \"Start Terminal\" to begin a session\n3. **Share URL** - Copy the secure URL to access your terminal from any browser\n4. **Access Terminal** - Open the URL in a web browser to access your terminal\n5. **Stop Terminal** - Click \"Stop Terminal\" when done\n\n### Security Notice\n\nEach terminal session is protected by a unique URL containing a 32-character random token. Only users with the exact URL can access the terminal. Keep URLs private and stop sessions when not in use.\n\n## Building\n\n### Prerequisites\n\n- [Node.js](https://nodejs.org/) (v18+)\n- [pnpm](https://pnpm.io/)\n- [Rust](https://rustup.rs/)\n- Platform-specific requirements:\n  - **macOS**: Xcode Command Line Tools\n  - **Windows**: Visual Studio Build Tools\n  - **Linux**: `webkit2gtk-4.0`, `libssl-dev`\n\n### Setup\n\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/ifokeev/codetunnel.git\n   cd codetunnel\n   ```\n\n2. Install dependencies:\n   ```bash\n   pnpm install\n   ```\n\n3. Download platform binaries:\n   ```bash\n   ./scripts/download-binaries.sh\n   ```\n\n   For macOS distribution builds:\n   ```bash\n   ./scripts/build-ttyd-macos.sh\n   ```\n\n### Development\n\nRun in development mode with hot reload:\n```bash\npnpm tauri:dev\n```\n\n### Production Build\n\nBuild for current platform:\n```bash\npnpm tauri:build\n```\n\nBuild for specific platforms:\n```bash\n# macOS Universal\npnpm tauri:build -- -- --target universal-apple-darwin\n\n# Windows x64\npnpm tauri:build -- -- --target x86_64-pc-windows-msvc\n\n# Linux x64\npnpm tauri:build -- -- --target x86_64-unknown-linux-gnu\n```\n\n## Project Structure\n\n```\ncodetunnel/\n├── apps/\n│   └── desktop/          # Tauri desktop application\n│       ├── src/          # React frontend\n│       └── src-tauri/    # Rust backend\n├── packages/             # Shared packages (future)\n├── scripts/              # Build and utility scripts\n└── pnpm-workspace.yaml   # Monorepo configuration\n```\n\n## Security\n\nCodeTunnel implements several security measures:\n\n- **URL-based Authentication**: Each session uses a cryptographically random 32-character token\n- **Local Process Isolation**: Terminal processes run with user permissions\n- **No Persistent Storage**: Sessions are temporary and not saved\n- **HTTPS Only**: Cloudflare tunnels provide encrypted connections\n\n### Best Practices\n\n- Only share URLs with trusted users\n- Stop sessions when not in use\n- Use Cloudflare Access for production deployments\n- Keep the application updated\n\n## Contributing\n\nWe welcome contributions! Please see our [Contributing Guidelines](CONTRIBUTING.md) for details.\n\n### Development Workflow\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Acknowledgments\n\n- [ttyd](https://github.com/tsl0922/ttyd) - Terminal server\n- [cloudflared](https://github.com/cloudflare/cloudflared) - Tunnel client\n- [Tauri](https://tauri.app/) - Desktop application framework\n- [React](https://reactjs.org/) - UI framework\n\n## Support\n\n- 📖 [Documentation](https://github.com/ifokeev/codetunnel/wiki)\n- 🐛 [Issue Tracker](https://github.com/ifokeev/codetunnel/issues)\n- 💬 [Discussions](https://github.com/ifokeev/codetunnel/discussions)\n\n## Roadmap\n\n- [ ] Auto-updater with signature verification\n- [ ] Multiple concurrent terminal sessions\n- [ ] Session persistence and reconnection\n- [ ] Custom shell configuration\n- [ ] Package manager distribution (Homebrew, Scoop, etc.)\n- [ ] Browser extension for quick access\n- [ ] Team collaboration features\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eAloha! 🌺\u003c/strong\u003e\u003cbr\u003e\n  Made with ❤️ and 🌴 by the CodeTunnel team\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fifokeev%2Fcodetunnel","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fifokeev%2Fcodetunnel","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fifokeev%2Fcodetunnel/lists"}