A personal AI assistant, built with developers in mind —
but capable of anything.
curl -fsSL ...install.sh | bash
npm i -g heymax
[background] auth-fix complete.python-kasa — it can control TP-Link smart devices.kasa-lights created ✓projects/myapp.md and cross-linked to [[vercel]]. I'll remember next time you mention deploys.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.
Max keeps a personal wiki that grows with every conversation — entity pages for the people, projects, and preferences in your life, cross-linked with [[wiki links]], tagged, and dated. A relevance-ranked table of contents is injected into context on every message, and Max writes daily conversation summaries on his own. Tell him once and he remembers forever.
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.
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.
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.
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.
Max delegates to specialist agents. @coder for implementation tasks, @designer for UI/UX work, or @general-purpose for anything else. Each runs in its own Copilot session with full tool access. Create your own agents with a simple markdown file.
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.
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.
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 ↗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:
Max ships with tools for orchestration, skills, and self-management. Extend with skills from skills.sh.
remember recall forgetLLM-maintained wiki of entity pages — people/burke.md, projects/max.md — with frontmatter, tags, and [[cross-links]]. remember fuzzy-matches existing pages so facts merge instead of duplicating. forget does line-removal, section-rewrite, or page deletion.
wiki_search wiki_read wiki_update wiki_ingest wiki_lintFull CRUD over the wiki. A ranked index is injected into context every message; Max drills in with wiki_read. Ingest URLs or docs as sources, and lint for broken links or orphan pages. Daily conversation summaries are written automatically.
delegate_to_agentDelegate tasks to specialist agents — @coder, @designer, @general-purpose, or your own. Each runs in its own Copilot session. Use @mentions or let Max route automatically.
list_machineDiscover every Copilot session on your machine — VS Code, terminal, anywhere. Attach and interact.
learn_skillPull skills from skills.sh or build your own. Email, calendar, smart home — Max learns anything instantly.
switch_modelSwitch between any model in your Copilot subscription — Claude, GPT, Gemini, and more. Just ask. Persisted across restarts.
create_agent remove_agentCreate custom agents with a markdown file — set the name, description, model, and system prompt. Bundled agents auto-sync on updates; your customizations are preserved.
restart_maxMax can restart himself. Spawns a replacement process and exits cleanly. Back online in seconds.
Install
curl ... | bash
Setup
max setup
Go
max start