Rename PyPI package to agent-strace

PyPI name 'agent-trace' conflicts with existing 'agenttrace' package
(PEP 503 normalization). CLI command is now 'agent-strace'.

GitHub repo, Python module (agent_trace), and trace directory
(.agent-traces/) are unchanged.

Co-authored-by: Ona <no-reply@ona.com>

Author: Siddhant-K-code

README.md

@@ -10,19 +10,19 @@ We have `strace` for syscalls. We have `tcpdump` for packets. We have nothing fo
 
 When a coding agent rewrites 20 files in a background session, you get a pull request. You don't get the story of how it got there. Which files did it read first? What context was in the window when it decided to change the approach? Why did it call the same tool three times?
 
-LangSmith traces LLM calls. That's one layer. The gap is everything around it: tool calls, file operations, decision points, error recovery. `agent-trace` captures the full picture.
+LangSmith traces LLM calls. That's one layer. The gap is everything around it: tool calls, file operations, decision points, error recovery. `agent-strace` captures the full picture.
 
 ## Install
 
 ```bash
 # With uv (recommended)
-uv tool install agent-trace
+uv tool install agent-strace
 
 # Or with pip
-pip install agent-trace
+pip install agent-strace
 
 # Or run without installing
-uvx agent-trace replay
+uvx agent-strace replay
 ```
 
 **Zero dependencies.** Python 3.10+ standard library only.
@@ -35,16 +35,16 @@ Wrap any MCP server. Every message between agent and server is captured.
 
 ```bash
 # Record a session
-agent-trace record -- npx -y @modelcontextprotocol/server-filesystem /tmp
+agent-strace record -- npx -y @modelcontextprotocol/server-filesystem /tmp
 
 # List recorded sessions
-agent-trace list
+agent-strace list
 
 # Replay the last session
-agent-trace replay
+agent-strace replay
 
 # Replay a specific session (prefix match works)
-agent-trace replay a84664
+agent-strace replay a84664
 ```
 
 ### Option 2: Python decorator
@@ -75,18 +75,18 @@ search_codebase("authenticate")
 call_llm([{"role": "user", "content": "Fix the bug"}])
 
 meta = end_session()
-print(f"Replay with: agent-trace replay {meta.session_id}")
+print(f"Replay with: agent-strace replay {meta.session_id}")
 ```
 
 ## CLI commands
 
 ```
-agent-trace record -- <command>    Record an MCP server session
-agent-trace replay [session-id]    Replay a session (default: latest)
-agent-trace list                   List all sessions
-agent-trace stats [session-id]     Show tool call frequency and timing
-agent-trace inspect <session-id>   Dump full session as JSON
-agent-trace export <session-id>    Export as JSON, CSV, or NDJSON
+agent-strace record -- <command>    Record an MCP server session
+agent-strace replay [session-id]    Replay a session (default: latest)
+agent-strace list                   List all sessions
+agent-strace stats [session-id]     Show tool call frequency and timing
+agent-strace inspect <session-id>   Dump full session as JSON
+agent-strace export <session-id>    Export as JSON, CSV, or NDJSON
 ```
 
 ### Replay output
@@ -146,23 +146,23 @@ Session Summary
 
 ```bash
 # Show only tool calls and errors
-agent-trace replay --filter tool_call,error
+agent-strace replay --filter tool_call,error
 
 # Replay with timing (watch it unfold)
-agent-trace replay --live --speed 2
+agent-strace replay --live --speed 2
 ```
 
 ### Export
 
 ```bash
 # JSON array
-agent-trace export a84664 --format json
+agent-strace export a84664 --format json
 
 # CSV (for spreadsheets)
-agent-trace export a84664 --format csv
+agent-strace export a84664 --format csv
 
 # NDJSON (for streaming pipelines)
-agent-trace export a84664 --format ndjson
+agent-strace export a84664 --format ndjson
 ```
 
 ## Trace format
@@ -210,7 +210,7 @@ Events link to each other. A `tool_result` has a `parent_id` pointing to its `to
 
 ## Use with Claude Code, Cursor, Windsurf
 
-agent-trace works with any tool that launches MCP servers. The idea is simple: instead of launching the MCP server directly, launch it through `agent-trace record`. The agent and server don't know the proxy exists.
+agent-strace works with any tool that launches MCP servers. The idea is simple: instead of launching the MCP server directly, launch it through `agent-strace record`. The agent and server don't know the proxy exists.
 
 ### Claude Code
 
@@ -219,7 +219,7 @@ agent-trace works with any tool that launches MCP servers. The idea is simple: i
 claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem /tmp
 
 # Use:
-claude mcp add filesystem -- agent-trace record --name filesystem -- npx -y @modelcontextprotocol/server-filesystem /tmp
+claude mcp add filesystem -- agent-strace record --name filesystem -- npx -y @modelcontextprotocol/server-filesystem /tmp
 ```
 
 Or edit `.claude/mcp.json`:
@@ -228,7 +228,7 @@ Or edit `.claude/mcp.json`:
 {
   "mcpServers": {
     "filesystem": {
-      "command": "agent-trace",
+      "command": "agent-strace",
       "args": ["record", "--name", "filesystem", "--", "npx", "-y", "@modelcontextprotocol/server-filesystem", "/tmp"]
     }
   }
@@ -243,7 +243,7 @@ Edit `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (per-project):
 {
   "mcpServers": {
     "filesystem": {
-      "command": "agent-trace",
+      "command": "agent-strace",
       "args": ["record", "--name", "filesystem", "--", "npx", "-y", "@modelcontextprotocol/server-filesystem", "/tmp"]
     }
   }
@@ -258,7 +258,7 @@ Edit `~/.codeium/windsurf/mcp_config.json`:
 {
   "mcpServers": {
     "filesystem": {
-      "command": "agent-trace",
+      "command": "agent-strace",
       "args": ["record", "--name", "filesystem", "--", "npx", "-y", "@modelcontextprotocol/server-filesystem", "/tmp"]
     }
   }
@@ -269,10 +269,10 @@ Edit `~/.codeium/windsurf/mcp_config.json`:
 
 The pattern is the same for any tool that uses MCP over stdio:
 
-1. Replace the server `command` with `agent-trace`
+1. Replace the server `command` with `agent-strace`
 2. Prepend `record --name <label> --` to the original args
 3. Use the tool normally
-4. Run `agent-trace replay` to see what happened
+4. Run `agent-strace replay` to see what happened
 
 See the [examples/](examples/) directory for full config files.
 
@@ -281,7 +281,7 @@ See the [examples/](examples/) directory for full config files.
 ### MCP proxy mode
 
 ```
-Agent ←→ agent-trace proxy ←→ MCP Server
+Agent ←→ agent-strace proxy ←→ MCP Server
               ↓
          .agent-traces/
 ```

examples/basic_agent.py

@@ -128,7 +128,7 @@ def main():
     print(f"  LLM requests: {meta.llm_requests}")
     print(f"  Errors: {meta.errors}")
     print(f"  Duration: {meta.total_duration_ms:.0f}ms")
-    print(f"\nReplay with: python -m agent_trace.cli replay {meta.session_id}")
+    print(f"\nReplay with: agent-strace replay {meta.session_id}")
 
 
 if __name__ == "__main__":

examples/claude_code_config.md

@@ -6,7 +6,7 @@ Claude Code launches MCP servers as subprocesses over stdio. agent-trace sits
 between Claude Code and the MCP server, capturing every tool call.
 
 ```
-Claude Code ←→ agent-trace record ←→ MCP Server
+Claude Code ←→ agent-strace record ←→ MCP Server
                      ↓
               .agent-traces/
 ```
@@ -17,10 +17,10 @@ Claude Code ←→ agent-trace record ←→ MCP Server
 
 ```bash
 # With uv (recommended)
-uv tool install agent-trace
+uv tool install agent-strace
 
 # Or with pip
-pip install agent-trace
+pip install agent-strace
 ```
 
 ### 2. Add a traced MCP server
@@ -32,7 +32,7 @@ Use `claude mcp add` with agent-trace wrapping the server command:
 claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem /tmp
 
 # Use:
-claude mcp add filesystem -- agent-trace record --name filesystem -- npx -y @modelcontextprotocol/server-filesystem /tmp
+claude mcp add filesystem -- agent-strace record --name filesystem -- npx -y @modelcontextprotocol/server-filesystem /tmp
 ```
 
 The `--name` flag tags the session so you can identify which server it came from.
@@ -43,7 +43,7 @@ The `--name` flag tags the session so you can identify which server it came from
 {
   "mcpServers": {
     "filesystem": {
-      "command": "agent-trace",
+      "command": "agent-strace",
       "args": [
         "record",
         "--name", "filesystem",
@@ -63,11 +63,11 @@ Every tool call Claude Code makes through the MCP server is now traced.
 
 ```bash
 # List all sessions
-agent-trace list
+agent-strace list
 
 # Replay the latest
-agent-trace replay
+agent-strace replay
 
 # Show stats
-agent-trace stats
+agent-strace stats
 ```

examples/cursor_config.md

@@ -12,10 +12,10 @@ so every tool call is captured.
 
 ```bash
 # With uv (recommended)
-uv tool install agent-trace
+uv tool install agent-strace
 
 # Or with pip
-pip install agent-trace
+pip install agent-strace
 ```
 
 ### 2. Edit your MCP config
@@ -26,7 +26,7 @@ Open `~/.cursor/mcp.json` (or `.cursor/mcp.json` in your project):
 {
   "mcpServers": {
     "filesystem": {
-      "command": "agent-trace",
+      "command": "agent-strace",
       "args": [
         "record",
         "--name", "filesystem",
@@ -35,7 +35,7 @@ Open `~/.cursor/mcp.json` (or `.cursor/mcp.json` in your project):
       ]
     },
     "github": {
-      "command": "agent-trace",
+      "command": "agent-strace",
       "args": [
         "record",
         "--name", "github",
@@ -60,7 +60,7 @@ All MCP tool calls are captured in `.agent-traces/`.
 ### 4. Replay
 
 ```bash
-agent-trace list
-agent-trace replay
-agent-trace stats
+agent-strace list
+agent-strace replay
+agent-strace stats
 ```

examples/windsurf_config.md

@@ -11,10 +11,10 @@ agent-trace wraps the server command to capture every tool call.
 
 ```bash
 # With uv (recommended)
-uv tool install agent-trace
+uv tool install agent-strace
 
 # Or with pip
-pip install agent-trace
+pip install agent-strace
 ```
 
 ### 2. Edit your MCP config
@@ -25,7 +25,7 @@ Open `~/.codeium/windsurf/mcp_config.json`:
 {
   "mcpServers": {
     "filesystem": {
-      "command": "agent-trace",
+      "command": "agent-strace",
       "args": [
         "record",
         "--name", "filesystem",
@@ -44,7 +44,7 @@ All MCP tool calls are captured in `.agent-traces/`.
 ### 4. Replay
 
 ```bash
-agent-trace list
-agent-trace replay
-agent-trace stats
+agent-strace list
+agent-strace replay
+agent-strace stats
 ```

pyproject.toml

@@ -3,7 +3,7 @@ requires = ["hatchling"]
 build-backend = "hatchling.build"
 
 [project]
-name = "agent-trace"
+name = "agent-strace"
 version = "0.1.0"
 description = "strace for AI agents. Capture and replay every tool call, LLM request, and decision point."
 readme = "README.md"
@@ -27,7 +27,7 @@ classifiers = [
 ]
 
 [project.scripts]
-agent-trace = "agent_trace.cli:main"
+agent-strace = "agent_trace.cli:main"
 
 [project.urls]
 Homepage = "https://github.com/Siddhant-K-code/agent-trace"

src/agent_trace/cli.py

@@ -1,11 +1,11 @@
 """CLI entry point.
 
 Usage:
-    agent-trace record -- <server-command> [args...]
-    agent-trace replay [session-id]
-    agent-trace list
-    agent-trace inspect <session-id>
-    agent-trace export <session-id> [--format json|csv]
+    agent-strace record -- <server-command> [args...]
+    agent-strace replay [session-id]
+    agent-strace list
+    agent-strace inspect <session-id>
+    agent-strace export <session-id> [--format json|csv]
 """
 
 from __future__ import annotations
@@ -42,8 +42,8 @@ def cmd_record(args: argparse.Namespace) -> int:
 
     if not args.quiet:
         sys.stderr.write(
-            f"agent-trace: recording session {meta.session_id}\n"
-            f"agent-trace: command: {' '.join(args.command)}\n"
+            f"agent-strace: recording session {meta.session_id}\n"
+            f"agent-strace: command: {' '.join(args.command)}\n"
         )
 
     on_event = _print_live_event if args.verbose else None
@@ -59,11 +59,11 @@ def cmd_record(args: argparse.Namespace) -> int:
 
     if not args.quiet:
         sys.stderr.write(
-            f"\nagent-trace: session {meta.session_id} complete\n"
-            f"agent-trace: {meta.tool_calls} tool calls, "
+            f"\nagent-strace: session {meta.session_id} complete\n"
+            f"agent-strace: {meta.tool_calls} tool calls, "
             f"{meta.llm_requests} llm requests, "
             f"{meta.errors} errors\n"
-            f"agent-trace: replay with: agent-trace replay {meta.session_id}\n"
+            f"agent-strace: replay with: agent-trace replay {meta.session_id}\n"
         )
 
     return returncode
@@ -241,10 +241,10 @@ def cmd_stats(args: argparse.Namespace) -> int:
 
 def build_parser() -> argparse.ArgumentParser:
     parser = argparse.ArgumentParser(
-        prog="agent-trace",
+        prog="agent-strace",
         description="strace for AI agents. Capture and replay every tool call.",
     )
-    parser.add_argument("--version", action="version", version=f"agent-trace {__version__}")
+    parser.add_argument("--version", action="version", version=f"agent-strace {__version__}")
     parser.add_argument(
         "--trace-dir",
         default=".agent-traces",