Experience the full power of an AI Agent without touching the terminal. Halo brings a visual, cross-platform desktop experience to everyone—open source and free.
Our Philosophy: Wrap complex technology into intuitive human interaction.
Claude Code is the most capable AI coding agent available. But there's a problem:
It's trapped in a terminal.
For developers comfortable with CLI, that's fine. But for designers, PMs, students, and anyone who just wants AI to do things — the terminal is a wall.
Halo is the first to break down that wall.
We took 100% of Claude Code's Agent capabilities and wrapped them in a visual interface that anyone can use. Same power, zero friction.
| Claude Code CLI | Halo | |
|---|---|---|
| Full Agent capabilities | ✅ | ✅ |
| Visual interface | ❌ | ✅ |
| One-click install | ❌ | ✅ |
| Remote access from any device | ❌ | ✅ |
| File preview & management | ❌ | ✅ |
| Built-in AI Browser | ❌ | ✅ |
Think of it like this: Windows turned DOS into visual desktops. Halo turns Claude Code CLI into a visual AI companion.
|
Not just chat. Halo can actually do things — write code, create files, run commands, and iterate until the task is done. Isolated workspaces keep your projects organized. Each Space has its own files, conversations, and context. See every file AI creates in real-time. Preview code, HTML, images — all without leaving the app. |
Control your desktop Halo from your phone or any browser. Work from anywhere — even from a hospital bed (true story). Let AI control a real embedded browser. Web scraping, form filling, testing — all automated. Extend capabilities with Model Context Protocol. Compatible with Claude Desktop MCP servers. |
- Multi-provider Support — Anthropic, OpenAI, DeepSeek, and any OpenAI-compatible API
- Real-time Thinking — Watch AI's thought process as it works
- Tool Permissions — Approve or auto-allow file/command operations
- Dark/Light Themes — System-aware theming
- i18n Ready — English, Chinese, Spanish (more coming)
- Auto Updates — Stay current with one-click updates
Remote Access: Control Halo from anywhere
AI browser Video Demo
ai_brower_480.mp4
| Platform | Download | Requirements |
|---|---|---|
| macOS (Apple Silicon) | Download .dmg | macOS 11+ |
| macOS (Intel) | Download .dmg | macOS 11+ |
| Windows | Download .exe | Windows 10+ |
| Linux | Download .AppImage | Ubuntu 20.04+ |
| Web (PC/Mobile) | Enable Remote Access in desktop app | Any modern browser |
That's it. Download, install, run. No Node.js. No npm. No terminal commands.
For developers who want to contribute or customize:
git clone https://github.com/openkursar/hello-halo.git
cd hello-halo
npm install
npm run prepare # Download binary dependencies for your platform
npm run devTo build for all platforms, run
npm run prepare:allfirst to download binaries for every target platform.
- Launch Halo and enter your API key (Anthropic recommended)
- Start chatting — try "Create a simple todo app with React"
- Watch the magic — see files appear in the Artifact Rail
- Preview & iterate — click any file to preview, ask for changes
Pro tip: For best results, use Claude Sonnet 4.5 or Opus 4.5 models.
┌─────────────────────────────────────────────────────────────────┐
│ Halo Desktop │
│ ┌─────────────┐ ┌─────────────┐ ┌───────────────────┐ │
│ │ React UI │◄──►│ Main │◄──►│ Claude Code SDK │ │
│ │ (Renderer) │IPC │ Process │ │ (Agent Loop) │ │
│ └─────────────┘ └─────────────┘ └───────────────────┘ │
│ │ │
│ ▼ │
│ ┌───────────────┐ │
│ │ Local Files │ │
│ │ ~/.halo/ │ │
│ └───────────────┘ │
└─────────────────────────────────────────────────────────────────┘
- 100% Local — Your data never leaves your machine (except API calls)
- No Backend Required — Pure desktop client, use your own API keys
- Real Agent Loop — Tool execution, not just text generation
Powered by Claude Code — Thanks to Anthropic for building the most capable AI agent.
Halo isn't just for developers. We've seen:
- Finance teams building full-stack apps from scratch — with zero coding experience
- Designers prototyping interactive mockups
- Students learning to code with AI as their pair programmer
- Developers shipping features faster than ever
The barrier isn't AI capability anymore. It's accessibility. Halo removes that barrier.
- Core Agent Loop with Claude Code SDK
- Space & Conversation management
- Artifact preview (Code, HTML, Images, Markdown)
- Remote Access (browser control)
- AI Browser (CDP-based)
- MCP Server support
- Plugin system
- Visual Git with AI-assisted review
- AI-powered file search
Halo is open source because AI should be accessible to everyone.
We welcome contributions of all kinds:
- Translations — Help us reach more users (see
src/renderer/i18n/) - Bug reports — Found something broken? Let us know
- Feature ideas — What would make Halo better for you?
- Code contributions — PRs welcome!
# Development setup
git clone https://github.com/openkursar/hello-halo.git
cd hello-halo
npm install
npm run prepare # Download binary dependencies for your platform
npm run devSee CONTRIBUTING.md for guidelines.
- GitHub Discussions — Questions & ideas
- Issues — Bug reports & feature requests
MIT License — see LICENSE for details.
If this project sparked an idea or helped you build something cool:
- Give us a star — it helps others find Halo
- Share your story — we love hearing what you built
- Link back to us — e.g.
Inspired by [Halo](https://github.com/openkursar/hello-halo)
A few months ago, it started with a simple frustration: I wanted to use Claude Code, but I was stuck in meetings all day.
During boring meetings (we've all been there), I thought: What if I could control Claude Code on my home computer from my phone?
Then came another problem — my non-technical colleagues wanted to try Claude Code after seeing what it could do. But they got stuck at installation. "What's npm? How do I install Node.js?" Some spent days trying to figure it out.
So I built Halo for myself and my friends:
- Visual interface — no more staring at terminal output
- One-click install — no Node.js, no npm, just download and run
- Remote access — control from phone, tablet, or any browser
The first version took a few hours. Everything after that? 100% built by Halo itself. We've been using it daily for months.
AI building AI. Now in everyone's hands.
Made with ❤️ by our contributors.
If Halo helps you build something amazing, we'd love to hear about it.
Star this repo to help others discover Halo.