Clawd Presence

Physical presence display for AI agents. Shows a customizable monogram (A-Z), status state, and current activity on a dedicated terminal/screen. Provides faster feedback than chat - glance at the display to see what the agent is doing. Use when setting up always-on agent visibility.

Security Scan

The skill's code, instructions, and requirements are consistent with a local terminal presence display and do not request unrelated credentials or remote installs.

Purpose & Capability

Name/description (physical presence display, monogram, states) matches the provided scripts and assets. The skill only needs local files (monograms, config.json, state.json) and the CLI described in SKILL.md to operate.

Instruction Scope

Runtime instructions only invoke included Python scripts which read/write local files (config.json, state.json) and display in a terminal. The configure script optionally attempts to read several expected clawdbot config files in the user's home directory when --auto is used (it imports PyYAML if available). This file access is consistent with the advertised auto-detection behavior, but it does mean the script will attempt to read specific files in the home directory if you run --auto.

Install Mechanism

No install spec or remote downloads are present. All code and assets are included in the bundle; nothing is fetched or executed from external URLs.

Credentials

The skill declares no required environment variables or credentials. The code does not attempt to read arbitrary env vars or request tokens; only optional dependency is PyYAML for auto-detection.

Persistence & Privilege

Skill is not always-enabled; it does not modify other skills or system-wide agent settings. It writes its own config.json and state.json under the skill directory (or repo root), which is expected for its function.

Assessment

This skill appears to be what it claims: a local terminal presence display. Before installing/running, note that: - The scripts will create and update config.json and state.json in the skill directory (or repo root). Put the code where you expect those files to be written or adjust paths if needed. - The configure --auto option tries to read a small set of clawdbot config files in your home directory (uses PyYAML if installed) to auto-detect an agent name — only use --auto if you trust those local config files will be read. - There are no network calls, no credentials requested, and nothing is downloaded at runtime. If you want extra assurance, inspect the included Python files (they are small and readable) before running and avoid running as a privileged user (no need for root).

Terminal-based presence display for AI agents.

Why

Chat has latency. A presence display inverts this - the agent broadcasts state continuously, you glance at it like a clock.

Setup

# Configure (auto-detect from clawdbot or manual)
python3 scripts/configure.py --auto
# or
python3 scripts/configure.py --letter A --name "AGENT"

# Run display in dedicated terminal
python3 scripts/display.py

Update Status

Call from your agent whenever starting a task:

python3 scripts/status.py work "Building feature"
python3 scripts/status.py think "Analyzing data"
python3 scripts/status.py idle "Ready"
python3 scripts/status.py alert "Need attention"
python3 scripts/status.py sleep

States

State	Color	Use
idle	Cyan	Waiting
work	Green	Executing
think	Yellow	Processing
alert	Red	Needs human
sleep	Blue	Low power

Auto-Idle

Returns to idle after 5 minutes of no updates. Prevents stale states.

python3 scripts/configure.py --timeout 300  # seconds, 0 to disable

Files

• scripts/display.py - Main display
• scripts/status.py - Update status
• scripts/configure.py - Settings
• assets/monograms/ - Letter designs A-Z