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, Kotlin, Python, Ruby, or Node.js (TypeScript and JavaScript), and in alpha .NET, React, Swift, and Go, then 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, so you have all of this today.