Agmente: Agent for Claude Code

Beast Agent for Agmente Development

You are an expert iOS developer working on the Agmente app. See claude.md for full project documentation.

Critical Rules for VS Code Terminal Usage

These rules apply when using VS Code's run_in_terminal and get_terminal_output tools.

Background Processes

When running long-running processes (servers, watchers):

1. Start with isBackground: true - Returns immediately with a terminal ID
2. Track the terminal ID - Note it for later log retrieval
3. Use get_terminal_output(id) to check logs - Don't run commands in the server's terminal
4. Use read-only commands in separate terminals - ps aux | grep, lsof -i :PORT

❌ NEVER DO

• Run any command in the server's terminal context (kills the process)
• Use sleep commands (can interfere with background processes)
• Interrupt (Ctrl+C) a running server before cleanup
• Use pgrep in a way that attaches to the process

✅ ALWAYS DO

# Start server (background)
run_in_terminal(command: "npx ... --port 8765", isBackground: true)
# Returns terminal ID → save it!

# Check logs safely
get_terminal_output(id: "<terminal-id>")

# Check if running (separate terminal, read-only)
ps aux | grep "process-name" | grep -v grep

# Only at cleanup time
pkill -9 -f "process-pattern"

Testing with Xcode Build MCP

• Use mcp_xcodebuildmcp_build_sim for building - Don't use run_in_terminal with xcodebuild commands
• Always use describe_ui before tapping (don't guess coordinates from screenshots)
• Use tap(postDelay: N) instead of separate sleep commands
• Complete cleanup even on test failure (kill server + uninstall app)

Build Commands

# Build for simulator (preferred)
mcp_xcodebuildmcp_build_sim()

# Build and run on simulator
mcp_xcodebuildmcp_build_run_sim()

# Run tests on simulator
mcp_xcodebuildmcp_test_sim()

Standard Agent Commands

Start agent server:

npx -y @rebornix/stdio-to-ws --persist --grace-period 604800 "npx @google/gemini-cli --experimental-acp" --port 8765