Zeus 4d57e93196 feat: single port config (dashboard on port, datasette on port+1)

- ARGUS_PORT now sets dashboard port, datasette auto-derives as port+1
- Dashboard dynamically injects correct datasette URL
- Simplifies multi-agent deployment (each agent gets own port namespace)
- Removed ARGUS_DASHBOARD_PORT env var

2026-02-22 10:34:57 +00:00

2.3 KiB

Raw Blame History

name	description
argus	GitHub/Forgejo community awareness tool. TRIGGERS: notifications, community triage, PR reviews, issue tracking, escalations. Use when managing GitHub notifications, logging community actions, or tracking escalations.

Argus Skill

CLI tool for GitHub/Forgejo community awareness — tracking notifications, logging activity, managing escalations.

Quick Start

# Initialize database
argus init

# Pull notifications from GitHub
argus notif pull

# View status
argus status

# Start dashboard
argus serve

Commands

Status & Info

argus version           # Show version
argus status            # Summary: pending, activity, escalations

Notifications

argus notif pull [--dry-run]       # Fetch from GitHub API
argus notif list [--pending]       # List notifications
argus notif act <id> <action>      # Mark as acted
argus notif dismiss <id> [reason]  # Dismiss
argus notif audit [--stale-hours]  # Auto-escalate stale

Activity Logging

argus activity log <action> <detail> [--issue ID]
argus activity list [--limit N]

Escalations

argus escalate create --category CAT --title "..."
argus escalate list [--status open]
argus escalate ack <id>
argus escalate resolve <id> --by WHO --resolution "..."

Service

argus serve [--port 8100] [--dashboard-port 8101]

Environment Variables

Variable	Default	Description
`ARGUS_DB`	`~/.argus/argus.db`	Database path
`ARGUS_PORT`	`8100`	Dashboard port (datasette on port+1)
`GH_TOKEN`	—	GitHub API token

Workflow

Pull notifications: argus notif pull
Review pending: argus notif list --pending
Act or dismiss: argus notif act <id> reviewed or argus notif dismiss <id> duplicate
Log activity: argus activity log commented "Answered question"
Check dashboard: Open http://localhost:8101

Sub-Agent Usage

For automated community management:

Read notifications with argus notif list --pending.
For each notification:
- If PR: review changes, comment if needed
- If issue: assess priority, respond or escalate
- Log action with argus activity log
After processing: argus notif audit

See procedures/subagent-completion.md for detailed patterns.

2.3 KiB Raw Blame History