max.

A personal AI assistant, built with developers in mind —
but capable of anything.

curl -fsSL ...install.sh | bash npm i -g heymax
built on github copilot sdk
max — via telegram
youFix the auth bug in ~/dev/myapp
maxOn it — spinning up a worker now.
sys[background] auth-fix complete.
maxAuth bug fixed. Expired JWT wasn't catching re-auth. Push a PR?
youCan you control my Kasa smart lights?
maxLet me look into that... found python-kasa — it can control TP-Link smart devices.
sysSkill kasa-lights created ✓
maxDone. I can now control your lights. Want me to turn them off?
_

Personal AI
assistant for
developers.

01

Always running

Max is a persistent daemon on your machine. Not a tab you close. Not a chat window. He's always on — running when you're coding, when you're on your phone, when you're asleep.

02

Codes while you're away

Max spins up real Copilot CLI sessions as workers. Dispatches tasks, works on your repos, and reports back to your phone. You can be walking your dog and a bug gets fixed.

03

GitHub-native

Integrated with GitHub out of the box. PRs, issues, branches, deploys — Max can do anything with your repos. No setup, no tokens to manage, just works.

04

Learns any skill

Max pulls from skills.sh — the open skills community library. Email, calendar, smart home, anything. If Max doesn't know how to do something, he can learn it instantly.

05

Your Copilot subscription

No new accounts. No extra cost. Max works with the models you already have — Claude, GPT, Gemini, and more. Just your existing GitHub Copilot subscription.


Skills.

Max uses the open skills standard. Pull from the skills.sh community library — or build your own. Anything Max doesn't know, he can learn instantly.

Gmail & Calendar gogcli/gmail GitHub PRs · issues · deploys Smart Home from skills.sh Web Browsing from skills.sh Community skills.sh library Your Thing Here ∞ possibilities

How it works.

📱 Telegram phone · desktop Terminal local TUI max. ORCHESTRATOR · MEMORY · SKILLS WORKERS Worker 1 Copilot CLI Worker 2 Copilot CLI Worker 3 Copilot CLI GitHub Copilot SDK MODELS · TOOLS · CONTEXT claude · gpt · gemini · ...

Built on Copilot.

Max isn't a wrapper around an API. He's built directly on the GitHub Copilot SDK — the same platform that powers Copilot in VS Code, the terminal, and GitHub.com. Every worker session is a real Copilot CLI instance. Works with your existing Copilot subscription — no new accounts needed.

Copilot SDK

Streaming sessions, tool calling, infinite context. The SDK handles model selection, automatic context compaction, and session persistence. Max uses all of it — and you choose the model: Claude, GPT, Gemini, or any model in your Copilot subscription.

Infinite sessions mean Max's conversation never hits a context wall — the SDK compacts intelligently in the background, preserving what matters.

SDK documentation ↗

Copilot CLI

Every worker is a full Copilot CLI. That means real file editing, terminal commands, git operations, code search — the same agent that runs in your terminal, orchestrated by Max.

Because Max builds on this mature agent harness, workers come pre-loaded with a full toolkit — no extra setup required:

  • File read / write / edit
  • Bash & terminal execution
  • Git operations & GitHub API
  • Code search (grep, glob, LSP)
  • Web fetch & browser automation
  • SQL / persistent memory
CLI documentation ↗

Built-in tools.

Max ships with tools for orchestration, skills, and self-management. Extend with skills from skills.sh.

Worker Sessions create_worker

Spin up Copilot CLI instances in any directory. Dispatch tasks, run them in parallel, get notified when done.

Memory remember recall

Persistent long-term memory backed by SQLite. Max saves preferences, facts, project context, and routines automatically.

Machine Sessions list_machine

Discover every Copilot session on your machine — VS Code, terminal, anywhere. Attach and interact.

Skills learn_skill

Pull skills from skills.sh or build your own. Email, calendar, smart home — Max learns anything instantly.

Model Switching switch_model

Switch between any model in your Copilot subscription — Claude, GPT, Gemini, and more. Just ask. Persisted across restarts.

Self-Management restart_max

Max can restart himself. Spawns a replacement process and exits cleanly. Back online in seconds.


Step 1 Install Max One command setup
Step 2 Message from phone Telegram or terminal
Step 3 Work gets done PRs, fixes, deploys

Get Max.

# one line install
$ curl -fsSL https://raw.githubusercontent.com/burkeholland/max/main/install.sh | bash
 
# or with npm
$ npm install -g heymax
01

Install

curl ... | bash
02

Setup

max setup
03

Go

max start