# Flameox

Coordinates local profiling, benchmark runs, and trace processing for coding agents using direct commands and precise file paths.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 217
- Author: morluto
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/morluto/flameox
- Updated: 2026-10-19
- HTML: https://affpapa.org/en/nevibecode/mcp/flameox

## What it does

The server exposes profiling tools, benchmark targets, and trace parsers directly to coding assistants. It avoids project configuration files and workspace initialization. For artifact analysis, the agent supplies exact filesystem paths; for live capture, it passes a discrete `argv` list alongside an absolute working directory. Flameox leaves project files untouched and does not crawl parent folders.

Captured metrics live in temporary session memory by default and disappear when the server process shuts down. For durable records, optional preservation writes data bundles indexed by SHA-256 into `FLAMEOX_DATA_DIR` or the default storage directory. The package requires Python 3.12 or newer to run.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add flameox -- uvx flameox
```
uvx runs the command named after the package; if the README names another one, use uvx --from flameox <command>

### Codex

**Platform CLI**
```bash
codex mcp add flameox -- uvx flameox
```
uvx runs the command named after the package; if the README names another one, use uvx --from flameox <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "flameox": {
            "command": "uvx",
            "args": [
                "flameox"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from flameox <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "flameox": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "flameox"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from flameox <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add flameox uvx flameox
```
uvx runs the command named after the package; if the README names another one, use uvx --from flameox <command>

## When to use it
- collect benchmark timings using explicit command arguments and directories
- inspect runtime trace artifacts via exact filesystem paths
- store preserved execution measurements keyed by SHA-256 hashes

## Example prompts
- Run a benchmark capture via Flameox for `python benchmark.py` in the current directory
- Inspect the trace artifact at `/tmp/run-trace.json` to find execution bottlenecks
- Check the preserved performance metrics for `evidence_id` and show metadata

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md