Skip to Content
DocumentationInstallation

Installation

For Developers

Tandemu installs into any of four agents: Claude Code, OpenCode, Cursor, or Codex CLI. All share the same /morning → /finish lifecycle, the same five skills, telemetry, and persistent memory.

Option A: Claude Code

In Claude Code, run:

/plugin marketplace add sebastiangrebe/tandemu
/plugin install tandemu
/reload-plugins

Exit and reopen Claude Code, then run:

/tandemu:setup

After setup completes, exit and reopen Claude Code once more to activate the memory server.

If the /tandemu:setup command doesn’t appear, try exiting and reopening Claude Code first, then run it.

The setup skill will:

  1. Ask whether you’re connecting to Tandemu Cloud or a self-hosted instance
  2. Open your browser for authentication
  3. Configure telemetry, permissions, and memory
  4. Install utility skills (/morning, /finish, /pause, /standup, /create)
  5. Set up the MCP memory server for persistent context

After that, open any project and run /morning to get started.

Option B: OpenCode

Clone the repo and run the installer with --target=opencode:

git clone https://github.com/sebastiangrebe/tandemu.git
cd tandemu
./install.sh --target=opencode

The installer authenticates you, registers @sebastiangrebe/opencode-plugin in ~/.config/opencode/opencode.json, and copies skills, commands, and AGENTS.md into ~/.config/opencode/. Bun auto-installs the plugin on the next opencode launch.

If you prefer to wire up opencode.json manually, the minimal config is:

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["@sebastiangrebe/opencode-plugin"]
}

You’ll still need to run ./install.sh --target=opencode once to configure auth and the MCP memory server.

Option C: Cursor

git clone https://github.com/sebastiangrebe/tandemu.git
cd tandemu
./install.sh --target=cursor

Installs the five skills as native slash commands in ~/.cursor/commands/, a global personality rule at ~/.cursor/rules/tandemu.mdc, and the OpenMemory MCP server in ~/.cursor/mcp.json. See Connecting Cursor for details.

Option D: Codex CLI

git clone https://github.com/sebastiangrebe/tandemu.git
cd tandemu
./install.sh --target=codex

Installs the five skills as slash prompts in ~/.codex/prompts/, personality in ~/.codex/AGENTS.md, and the OpenMemory MCP server under [mcp_servers.tandemu] in ~/.codex/config.toml. See Connecting Codex CLI for details.

Option E: Install script (multi-agent / scripted)

./install.sh                            # auto-detects installed agents and prompts
./install.sh --target=cursor,codex      # comma-separated for multiple
./install.sh --target=all               # everything detected
./install.sh --target=both              # legacy alias: claude + opencode

Run from the Tandemu repo directory. Useful for scripted onboarding or CI/CD.

Prerequisites

  • At least one of: Claude Code (install ), OpenCode (install ), Cursor (install ), or Codex CLI (install )
  • python3 — for configuration (pre-installed on macOS/Linux)
  • curl — for downloading (pre-installed on macOS/Linux)

Re-authenticate

If your token expires or you need to switch organizations:

  • Claude Code plugin: run /tandemu:setup again
  • OpenCode / Cursor / Codex / script: re-run ./install.sh with the appropriate --target= flag (or no flag to auto-detect)

All paths detect existing config and re-authorize.

Manage installation

./install.sh --check       # Check for updates
./install.sh --uninstall   # Remove all Tandemu files

For Platform Administrators

Looking to deploy Tandemu on your own infrastructure? See the Self-Hosting guide for full setup instructions, configuration, and management.

Last updated on
IntroductionSetup