CLI Quickstart

The whole engine. No editor required.

1

Download the CLI

Grab the binary for your platform from the AppMap releases page, rename it to appmap (appmap.exe on Windows), and put it on your PATH.
2

Set up your project

Run appmap install in your project root. It configures the AppMap trace agent for Java, Python, Ruby, or Node and writes appmap.yml.
3

Record

Run your tests, or exercise your app, with the agent enabled. Traces land in tmp/appmap.
4

Index

Run appmap index once, or appmap index --watch to keep the index fresh while you work. The editor extensions do this automatically.
5

Connect your coding agent

Point any MCP client at the AppMap MCP server.
{"mcpServers": {"appmap": {"command": "appmap", "args": ["query", "mcp"]}}}

Already using a VS Code or JetBrains extension? The CLI is bundled; you have all of this today.