Skip to content
Projects

oneo-me/nsgo-agio has 10 GitHub stars and 2 forks. Star changes are not measured yet. Last checked 2026-11-16 00:50 UTC. Last push 2026-11-13.

How these counts are measured

Measured star growth

in 24h
Update delayed
in 7 days
Update delayed
in 15 days
Update delayed
in 1 month
Update delayed

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

The agent core of NSGo apps: run coding agents (pi, Codex, Claude Code, CodeBuddy Code) and show their work on phones and desktops, in one process or as a server and its clients

AI

README.md

Original

Agio

English | 简体中文

Website GitHub Blog X GitHub Sponsors

The agent core of NSGo apps: run coding agents (pi, Codex, Claude Code, CodeBuddy Code) and show their work on phones and desktops, in one process or as a server and its clients.

Agio's window: a task with two turns beside the sidebar's tasks

Agio is two things:

  • A library. Other NSGo apps build their own development environments on it: drivers for each agent CLI, a host that runs them on macOS, Windows or Linux, a wire protocol to reach them from another process or a phone, and views for phones and desktops, behind one neutral API.
  • An app. Agio, in cmd/agio, is that core in a window of its own, to demonstrate and test it, and a simple tool for working with agents: tasks in projects, agent and model settings, color schemes, notifications and automatic updates.

Download

Download Agio for macOS, Windows or Linux, on arm64 or x64, from the latest release. It updates itself from GitHub's releases: on macOS and Windows it installs them, and on Linux it opens the release.

Agio runs the agent CLIs on the login shell's PATH with your own sign-ins. It sends anonymous usage statistics to Umami: when it is open and used, and which agents messages go to, never prompts or folders. Builds run with nsgo dev send nothing, and its settings turn them off.

Install the library

go get github.com/oneo-me/[email protected]

It needs Go 1.27 and the agent CLIs you want on the login shell's PATH; it runs them with your own sign-ins.

Usage

An application chooses where its agents run by the backend it shows. In one process, a host.Host runs them:

h := host.New(host.Options{Dir: workDir})
nsgo.Run(func(cx *core.Scope) core.Node {
	return chatview.App{Model: chatview.Bind(cx, h)}
})
h.Close()

As a server and its clients, the server serves its host and a client shows a wire.Client instead:

// Server
wire.ListenAndServe(host.New(host.Options{Dir: workDir}), "127.0.0.1:7788", token)

// Client
c, err := wire.Dial("127.0.0.1:7788", token)
nsgo.Run(func(cx *core.Scope) core.Node {
	return chatview.App{Model: chatview.Bind(cx, c)}
})

chatview.Conversation shows a single conversation for an application with its own layout, and wire.Serve serves any byte stream, such as an SSH session. Agents run with full access to the server's files, so keep a server on a private network and give it a token.

Agio runs its agents in one process; the examples run as a server and its client:

Program Run
Agio go tool nsgo dev cmd/agio
Server go run ./examples/server -token secret
Client AGIO_TOKEN=secret go tool nsgo dev examples/client

go tool nsgo build cmd/agio builds Agio for macOS, Windows and Linux, on arm64 and x64. Releases update themselves from the latest GitHub release when built with NSGO_UPDATES_KEY, the secret key of updates.key in cmd/agio/nsgo.yaml. go build -tags agiodemo ./cmd/agio builds a demo that shows scripted tasks instead of running agents, which the website's screenshots use.

Pushing a tag v<version> matching version in cmd/agio/nsgo.yaml, such as v0.1.0, publishes that version: the Go module, and a GitHub release of Agio with its CHANGELOG.md section as the notes, built with the NSGO_UPDATES_KEY repository secret.

Documentation

ARCHITECTURE.md maps the packages and the boundaries between them.

Development

Run go tool nsgo check and go tool nsgo test from the repository root. See AGENTS.md for how changes are made. The website is in website/.

See CHANGELOG.md for release notes.

License

MIT, see LICENSE.