Skip to main content

Installation

Install Max in seconds with a single curl command or npm.

Quickstart

Get Max running and talk to it in under 5 minutes.

Commands

Full reference for all Max CLI commands and flags.

Architecture

Understand how Max orchestrates Copilot sessions.

​
What is Max?

Max is a personal AI daemon for developers. It runs persistently on your machine, powered by the GitHub Copilot SDK, and acts as an always-on orchestrator that you can reach from anywhere. Send it a message from your phone via Telegram, or open a terminal and type. Max handles the rest — spinning up coding sessions in the right directories, remembering your preferences, and reporting back when work is done. 
Telegram ──→ Max Daemon ←── TUI
                │
          Orchestrator Session (Copilot SDK)
                │
      ┌─────────┼─────────┐
   Worker 1  Worker 2  Worker N
  (coding sessions in specific directories)

​
Key features

Persistent orchestrator

One long-running Copilot session that survives restarts and recovers context automatically.

Multi-interface

Control Max from Telegram (remote) or the TUI (local terminal) — same brain, different inputs.

Worker sessions

Max spawns child Copilot sessions in specific directories for focused coding tasks.

Skill system

Install documentation-based skills to teach Max how to use external tools like Gmail or Calendar.

Long-term memory

Max remembers your preferences, projects, and routines in a local SQLite database.

Smart model routing

Max automatically selects the right model tier based on task complexity.

HTTP API

A local REST API on port 7777 lets you integrate Max into your own tools and scripts.

MCP server support

Load MCP servers from your Copilot CLI config to extend Max’s capabilities.

​
Example interactions

Once Max is running, just send natural language from Telegram or the TUI: 
"Start working on the auth bug in ~/dev/myapp"
"What sessions are running?"
"Check on the api-tests session"
"Kill the auth-fix session"
"Remember that I prefer TypeScript over JavaScript"
"What's the capital of France?"
Max decides whether to answer directly, delegate to a worker session, or use a skill — no commands to memorize.

​
Everything stays local

Max stores all configuration, memory, conversation history, and skills in ~/.max/ on your machine. No cloud sync, no data leaving your machine (except via Copilot SDK’s normal API calls).

Get started

Install and run Max in minutes

Read the architecture guide

Understand how Max works under the hood

Build docs developers (and LLMs) love

Get started for freeTalk to us