Skip to content
gitcoffee-osPublic

About

Run agent work. Keep control. Ship from anywhere. Magio is an open-source workspace for running and reviewing AI coding work on desktop, web, VS Code, and mobile.

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

5 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Magio

GitHub stars GitHub release Discord Support the project

CI powered by Blacksmith

Forked from openchamber/openchamber (MIT). The OpenChamber-derived code stays under the MIT License, reproduced in NOTICE. Magio's own code is under the GitCoffee Open Source License.

Run agent work. Keep control. Ship from anywhere.

Magio is an open-source workspace for running and reviewing AI coding work on desktop, web, VS Code, and mobile.

Start agent work, see what changed, and take it through review and release. Your projects and sessions remain available when you switch devices or step away.

Magio Chat

More screenshots

VS Code Extension

Magio PWA chat Magio PWA diff review

What you can do with Magio

Goals that continue on their own

Give a session a finish line with Session Goals. Magio checks the result after every turn and keeps the agent working until it completes the goal, gets blocked, or reaches the limit you set. It can continue after you close the app.

Compare and combine runs

Use Multi-run to give the same task to up to five models, each in its own session and optionally its own worktree. See what each one actually built, choose the best result, or use Fusion to combine the strongest parts into a new session.

Guided changes walkthroughs

Changes Walkthrough turns a large diff into an AI-guided tour of the change. It groups related edits into steps, puts them in the order the change makes sense, and explains how the pieces fit together.

Inspect a running app

Open your app beside the conversation with Preview. Point at an element to send the agent its screenshot, styles, position, and browser errors. No more trying to explain "this thing here." The desktop app can do the same with any web page in its built-in browser.

GitHub context from issue to pull request

Start a session from a GitHub issue or pull request with its context attached. Send failed checks or review comments back to the agent, then update or merge the pull request from Magio.

Continue on another device

Open the same projects and sessions from Desktop, Web/PWA, VS Code, iOS, or Android. Check progress, answer questions, review changes, and reattach to a running terminal.

Private remote access

Pair a device with a one-time QR code and connect through Private Relay without opening ports or exposing a public server. The connection is end-to-end encrypted and can be revoked at any time. Direct connections, LAN/VPN access, Cloudflare/Ngrok tunnels, and SSH are also supported.

Track work across projects

See which sessions are working, waiting, finished, or failed, along with approvals, scheduled tasks, provider limits, token use, and costs. Organize sessions into folders and keep notes, todos, and reusable project actions nearby.

Schedule recurring work

Run a prompt once, daily, weekly, or on a cron schedule. Scheduled tasks can use Session Goals, so they continue toward an outcome instead of stopping after one response.

Use it where you work

Surface Role
Desktop The complete workspace for macOS, Windows, and Linux, with multiple windows, Mini Chat, remote machines, SSH, and native notifications
Web / PWA Open your workspace in a browser, install it as an app, and stay up to date through background notifications
VS Code Keep sessions beside your code, send selections to the agent, open results in the editor, and compare parallel runs
iOS / Android Review and steer work away from your desk, receive completion alerts, and use the terminal with touch controls
CLI / Server Run Magio on a workstation or server, schedule work, manage remote access, and keep it available after login

Quick start

Desktop for macOS, Windows, and Linux

Download the latest release from GitHub Releases. Desktop bundles the matching OpenCode CLI, so no separate OpenCode installation is required.

Linux releases are available as x86_64 and ARM64 AppImages. Make the downloaded AppImage executable and keep it in a writable location for in-app updates:

chmod +x Magio-*.AppImage
./Magio-*.AppImage

Linux AppImages require FUSE (libfuse.so.2). Without FUSE, run with APPIMAGE_EXTRACT_AND_RUN=1.

VS Code

Install Magio from the Visual Studio Marketplace, or search for "Magio" in Extensions.

CLI for Web and PWA

Requires Node.js 24.14+. CLI/Web and VS Code use your installed OpenCode CLI.

curl -fsSL https://raw.githubusercontent.com/gitcoffee-os/magio/main/scripts/install.sh | bash
magio --ui-password be-creative-here

Common operations:

magio status
magio connect-url --qr
magio tunnel start --provider cloudflare --mode quick --qr
magio startup enable
magio logs
magio stop
magio update

Magio binds to localhost by default. Use --lan only on a trusted network and protect browser access with --ui-password.

Guides

Go deeper with the Magio guides:

For self-hosting details, see the reverse proxy guide. For custom theme authoring, see the custom themes guide.

Why OpenCode?

Magio uses OpenCode to run coding agents. We chose it because it is open source, has a solid API, and is easy to extend.

Magio handles the rest of the workflow. You can decide what to try, keep the agent on track, review the result, connect from another device, and ship the change.

Magio is an independent project and is not affiliated with the OpenCode or OpenChamber teams.

Contributing

Bug fixes and small improvements are welcome as PRs. Features and behavior changes start in an Ideas discussion so we agree on the product side before anyone writes code. Read CONTRIBUTING.md before opening a PR; it has the setup, the review contract, and what happens to large unplanned PRs. Documentation authoring guidance lives in packages/docs.

Bugs go to issues. Questions go to Q&A discussions.

Acknowledgments

Special thanks to:

  • OpenCode for the API and open-source architecture Magio builds on
  • Pierre for the diff viewer and syntax highlighting
  • The T3 Code team for their browser adapter for libghostty-vt, which our terminal is built on
  • Yulia Ivashko, who built the firework celebration that plays on every successful push
  • Everyone who contributed code, reported bugs, or shared ideas

License

Magio uses the GitCoffee Open Source License: the Apache License, Version 2.0 with additional conditions, so it is not plain Apache 2.0. The conditions, and what they cover, are in LICENSE.

Magio is a fork of OpenChamber, published under the MIT License. NOTICE reproduces that notice, as the MIT terms require, and the OpenChamber-derived code stays under MIT.

About

Run agent work. Keep control. Ship from anywhere. Magio is an open-source workspace for running and reviewing AI coding work on desktop, web, VS Code, and mobile.

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages