avc

AVC — Agent View Controller

AVC is a visual interaction tool that transforms JSON into interactive native WebView UIs. Use it when you need human approval for complex decisions.

When to Use

Use avc instead of printing plain text when:

• Execution plans with more than 3 steps
• Architecture changes involving multiple modules
• Multi-file refactoring plans
• Deployment sequences that need human review
• Any complex plan where the human should visually review and reorder steps

Prerequisites

avc must be installed and available in PATH:

# From source
git clone https://github.com/study8677/Agent_View_Controller-AVC.git
cd Agent_View_Controller-AVC && go build -o avc . && sudo cp avc /usr/local/bin/

How to Use

Step 1: Construct JSON

Build a JSON object with view type and structured data:

{
  "view": "plan",
  "title": "Your Plan Title",
  "lang": "en",
  "editable": true,
  "token_count": 4500,
  "data": {
    "steps": [
      {"id": 1, "label": "Step description", "status": "pending"},
      {"id": 2, "label": "Another step", "status": "pending"}
    ]
  }
}

Tip — lang field: Localizes UI chrome (buttons / status bar / tooltips) only — not step content. Supported: en (default), zh, ja, ko, es, fr, de. Match it to the language of your step labels for a consistent UI.

Step 2: Pipe to AVC

echo '<json>' | avc

Step 3: Read the Result

• Exit code 0 = human confirmed → stdout contains modified JSON
• Exit code 130 = human cancelled

RESULT=$(echo '{"view":"plan","title":"My Plan","token_count":5000,"data":{"steps":[{"id":1,"label":"Step 1","status":"pending"}]}}' | avc)

if [ $? -eq 0 ]; then
  # Parse $RESULT — human may have reordered, edited, or removed steps
  echo "$RESULT"
else
  echo "Human cancelled"
fi

Important Behavior

1. avc blocks until the human clicks Confirm or Cancel
2. stdout contains the human-modified JSON (may have reordered/edited/removed steps)
3. If token_count ≤ 3000 (default threshold), AVC passes through without opening a window
4. Use --no-threshold to always show the WebView window
5. Use --threshold=N to set a custom threshold