Skip to main content
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 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.

​
How it works

Max starts a persistent orchestrator Copilot session that runs as a background daemon on your machine. When you send a message, the orchestrator decides how to handle it:
  • Simple questions — answered directly by the orchestrator.
  • Coding tasks — the orchestrator spawns a worker Copilot session in the relevant directory, runs the task in the background, and notifies you when it’s done.
  • Tool use — skills, memory recall, and session management are all handled through the orchestrator’s tool set.
You can reach the daemon from two interfaces:
  • Telegram — send messages from your phone; useful for dispatching tasks while away from your desk.
  • TUI — a local terminal client (max tui) that connects to the running daemon.
Telegram ──→ Max Daemon ←── TUI
                │
          Orchestrator Session (Copilot SDK)
                │
      ┌─────────┼─────────┐
   Worker 1  Worker 2  Worker N

​
Who it’s for

Max is built for developers who want an always-on AI assistant that:
  • Runs entirely on their own machine (no cloud sync, no data leaving except via Copilot SDK’s normal API calls)
  • Can manage multiple background coding tasks simultaneously
  • Is reachable from anywhere — phone or terminal
  • Learns new capabilities over time through a skill system
  • Remembers preferences, projects, and context across sessions

​
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, up to 5 concurrently.

Skill system

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

Long-term memory

Max remembers your preferences, projects, and routines in a local SQLite database at ~/.max/.

Smart model routing

Max automatically selects the right model tier based on task complexity, with keyword overrides.

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 (~/.copilot/mcp-config.json) to extend Max’s capabilities.

​
Everything stays local

All configuration, memory, conversation history, and skills are stored in ~/.max/ on your machine:
PathContents
~/.max/.envConfig: tokens, model, API port
~/.max/max.dbSQLite: sessions, conversation log, memories
~/.max/skills/Installed skills
~/.max/api-tokenBearer token for the local HTTP API

Installation

Install Max with a single curl command or npm.

Quickstart

Get Max running and send your first message in minutes.

Build docs developers (and LLMs) love

Get started for freeTalk to us