diff --git a/AGENTS.md b/AGENTS.md index 3c38f1ab0..1b1a5b209 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -100,7 +100,7 @@ - CLI progress: use `src/cli/progress.ts` (`osc-progress` + `@clack/prompts` spinner); don’t hand-roll spinners/bars. - Status output: keep tables + ANSI-safe wrapping (`src/terminal/table.ts`); `status --all` = read-only/pasteable, `status --deep` = probes. - Gateway currently runs only as the menubar app; there is no separate LaunchAgent/helper label installed. Restart via the Clawdbot Mac app or `scripts/restart-mac.sh`; to verify/kill use `launchctl print gui/$UID | grep clawdbot` rather than assuming a fixed label. **When debugging on macOS, start/stop the gateway via the app, not ad-hoc tmux sessions; kill any temporary tunnels before handoff.** -- macOS logs: use `./scripts/clawlog.sh` (aka `vtlog`) to query unified logs for the Clawdbot subsystem; it supports follow/tail/category filters and expects passwordless sudo for `/usr/bin/log`. +- macOS logs: use `./scripts/clawlog.sh` to query unified logs for the Clawdbot subsystem; it supports follow/tail/category filters and expects passwordless sudo for `/usr/bin/log`. - If shared guardrails are available locally, review them; otherwise follow this repo's guidance. - SwiftUI state management (iOS/macOS): prefer the `Observation` framework (`@Observable`, `@Bindable`) over `ObservableObject`/`@StateObject`; don’t introduce new `ObservableObject` unless required for compatibility, and migrate existing usages when touching related code. - Connection providers: when adding a new connection, update every UI surface and docs (macOS app, web UI, mobile if applicable, onboarding/overview docs) and add matching status + configuration forms so provider lists and settings stay in sync. diff --git a/scripts/clawlog.sh b/scripts/clawlog.sh index 53cee1faa..49e877090 100755 --- a/scripts/clawlog.sh +++ b/scripts/clawlog.sh @@ -21,7 +21,7 @@ handle_sudo_error() { echo -e "\n${RED}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}" echo -e "${YELLOW}⚠️ Password Required for Log Access${NC}" echo -e "${RED}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}\n" - echo -e "vtlog needs to use sudo to show complete log data (Apple hides sensitive info by default)." + echo -e "clawlog needs to use sudo to show complete log data (Apple hides sensitive info by default)." echo -e "\nTo avoid password prompts, configure passwordless sudo for the log command:" echo -e "See: ${BLUE}apple/docs/logging-private-fix.md${NC}\n" echo -e "Quick fix:" @@ -51,7 +51,7 @@ show_usage() { clawlog - Clawdbot Logging Utility USAGE: - vtlog [OPTIONS] + clawlog [OPTIONS] DESCRIPTION: View Clawdbot logs with full details (bypasses Apple's privacy redaction). @@ -69,10 +69,10 @@ LOG CATEGORIES (examples): • shell - ShellExecutor QUICK START: - vtlog -n 100 Show last 100 lines from all components - vtlog -f Follow logs in real-time - vtlog -e Show only errors - vtlog -c ServerManager Show logs from ServerManager only + clawlog -n 100 Show last 100 lines from all components + clawlog -f Follow logs in real-time + clawlog -e Show only errors + clawlog -c ServerManager Show logs from ServerManager only OPTIONS: -h, --help Show this help message @@ -91,15 +91,15 @@ OPTIONS: --json Output in JSON format EXAMPLES: - vtlog Show last 50 lines from past 5 minutes (default) - vtlog -f Stream logs continuously - vtlog -n 100 Show last 100 lines - vtlog -e Show only recent errors - vtlog -l 30m -n 200 Show last 200 lines from past 30 minutes - vtlog -c ServerManager Show recent ServerManager logs - vtlog -s "fail" Search for "fail" in recent logs - vtlog --server -e Show recent server errors - vtlog -f -d Stream debug logs continuously + clawlog Show last 50 lines from past 5 minutes (default) + clawlog -f Stream logs continuously + clawlog -n 100 Show last 100 lines + clawlog -e Show only recent errors + clawlog -l 30m -n 200 Show last 200 lines from past 30 minutes + clawlog -c ServerManager Show recent ServerManager logs + clawlog -s "fail" Search for "fail" in recent logs + clawlog --server -e Show recent server errors + clawlog -f -d Stream debug logs continuously CATEGORIES: Common categories include: