Maple Harness home

Maple Harness 2.6.2 released! What's new in 2.6.2

Single userTeams & hubs

One person, one machine: the agent, the proxy and your own usage.

Several people, from one shared proxy up to a hub of hubs.

Overview #

On this page
  1. In plain words
  2. Start here
  3. Get started
  4. Guides
  5. Cost and usage
  6. Reference
  7. Help

Maple Harness is a coding agent for GitHub Copilot's models, Claude and models on your own machine. It comes in three parts:

  • The agent, maple-harness: the program you work with in a terminal. It reads your project, edits files and runs commands, and asks before it changes anything.
  • The proxy, maple-proxy: holds your sign-ins and talks to the models, for the agent and for any other tool that speaks the OpenAI or Anthropic API. Its setup page is where you sign in and change settings.
  • The phone page: share a session and drive it from your phone's browser, or from another computer.

On a Mac with Apple silicon there is also a small helper for Apple's on-device model, which the proxy starts when it is needed.

In plain words #

  • The agent is where you work: type what you want done in a terminal, and it reads, edits and runs, asking first.
  • The proxy holds your accounts and models. Its setup page, at http://127.0.0.1:11539, is where you sign in and change settings, with nothing to edit by hand.
  • Your phone can follow a session and approve what the agent asks.
  • Curious what makes it different? What's inside Maple describes the capabilities in plain words.

Start here #

  1. Install the programs.
  2. Run Your first session.
  3. Sign in to GitHub Copilot or Claude, or Connect a model server such as Ollama or LM Studio.
  4. Choose a model, or let the agent choose for each message.

Get started #

Installing, signing in and connecting models.

  • What's inside Maple: what it does for you behind the scenes, and why it helps.
  • Install: the one-line installer, platforms, updating and removing it.
  • Upgrading to 2.0: what keeps working, what is new, and how to go back to 1.x.
  • Which setup do I need?: one laptop, a laptop joined to a team hub, a team hub, chained hubs, several replicas, or CI: what each gives you and where its steps are.
  • Your first session: start the proxy and the agent, and the first commands to know.
  • Sign in: GitHub Copilot, an Anthropic API key, and more than one account.
  • Azure and Google Cloud: Azure OpenAI, Microsoft Foundry and Vertex AI with your cloud sign-in.
  • Amazon Bedrock: Claude, Nova, Llama and more in your AWS account, with your AWS credentials.
  • Connect a model server: Ollama, LM Studio, oMLX, Lemonade, Unsloth or any OpenAI-compatible server.
  • Choose a model: switch models, let the agent choose, and set a default.

Guides #

How each part works, and how to use it with other tools.

The agent

The proxy

Your phone

Other tools

Cost and usage #

Where the spend goes, how to keep it down, and how to check any claim on your own tasks.

Your data

Reference #

Every command, key and setting, with what it does, its default and its trade-off.

Help #

When something does not work, and the rest.

Made with ❤️ by Kinn Coelho Juliao in Ottawa, eh — fuelled by double-doubles, bud. 🍁