agent/codex/perf/commands/perf.md
Snider e90a84eaa0 feat: merge go-agent + go-agentic + php-devops into unified agent repo
Combines three repositories into a single workspace:
- go-agent → pkg/orchestrator (Clotho), pkg/jobrunner, pkg/loop, cmd/
- go-agentic → pkg/lifecycle (allowance, sessions, plans, dispatch)
- php-devops → repos.yaml, setup.sh, scripts/, .core/

Module path: forge.lthn.ai/core/agent

All packages build, all tests pass.

Co-Authored-By: Virgil <virgil@lethean.io>
2026-03-06 15:23:00 +00:00

1.1 KiB

name description args
perf Performance profiling helpers for Go and PHP. <subcommand> [options]

Performance Profiling

Profile test suite, HTTP requests, and analyze slow queries and memory usage.

Subcommands

  • test: Profile the test suite.
  • request <url>: Profile an HTTP request.
  • query <query>: Analyze a slow query (requires MySQL client and credentials).
  • memory [script_path]: Analyze memory usage.

Usage

/core:perf test
/core:perf request /api/users
/core:perf query "SELECT * FROM users WHERE email = 'test@example.com'"
/core:perf memory

Actions

Test Profiling

Run this command to profile the test suite:

"${CLAUDE_PLUGIN_ROOT}/scripts/perf-test.sh"

Request Profiling

Run this command to profile an HTTP request:

"${CLAUDE_PLUGIN_ROOT}/scripts/perf-request.sh" "<url>"

Query Analysis

Run this command to analyze a slow query:

"${CLAUDE_PLUGIN_ROOT}/scripts/perf-query.sh" "<query>"

Memory Analysis

Run this command to analyze memory usage:

"${CLAUDE_PLUGIN_ROOT}/scripts/perf-memory.sh" "<script_path>"