memcode docs

Quickstart

From a fresh install to your first working agent turn.

This takes you from nothing to a working memcode session in a few minutes.

1. Install

curl -fsSL https://memcode.ai/install.sh | sh

See Installation for the Go and from-source options.

2. Connect a backend

Memcode needs a backend to talk to a model. The first time you run it in a terminal, a short wizard offers the options it detects. The lowest-friction paths:

If ANTHROPIC_API_KEY or OPENAI_API_KEY is already exported in your shell, memcode uses it automatically. Nothing to set up.

If you have a Claude, ChatGPT, Copilot, or Grok subscription, run memcode on it at no extra cost. The wizard finds existing logins and offers them; you can also pick one directly:

memcode auth use claude      # Claude Pro/Max
memcode auth use codex       # ChatGPT
memcode auth use copilot     # GitHub Copilot
memcode auth use grok        # SuperGrok / X Premium+

If you want a hosted account with one balance across vendors:

memcode login

Full details are in Authentication.

3. Run your first task

Change into a git repository and give memcode a task:

cd ~/code/my-project
memcode run "add a health check endpoint at /healthz that returns 200"

Memcode reads up on your project, does the work, and in the default ask mode pauses for your approval before anything risky.

4. Or work interactively

Run memcode with no arguments for an interactive session:

memcode

Type tasks in plain language. Slash commands steer as you go: /plan to plan a change before making it, /model to switch models, /mode to change how much it does on its own, and /cost to see what the session has spent. The full list is in Slash commands.

5. Come back later

Your work is remembered. Continue the most recent session with its full history:

memcode --continue

See Memory for resuming a specific session and everything else memcode keeps.

Things to try

Ask in plain language. A few starting points:

explain how requests flow through this service
fix the failing test in internal/auth and show me the diff
/plan move the config loader from JSON to YAML

Some requests use memcode features beyond editing code. You don't need special commands for them; just ask:

every Monday morning, check this repo's dependencies for updates and tell me what changed
save these steps as a script called release: run the tests, then tag and push
publish report.html as a page I can share
make me a website for my bakery

The first sets up a task memcode runs on its own on that schedule; see and manage your tasks with memcode task list and check results with memcode task inbox. The second saves a recipe you can replay by name. The third publishes the file as a shareable memcode.ai page. The last builds a site with Websites.

On this page