Argos 👁️

A personal operations dashboard for OpenClaw users. Monitor tasks, calendar events, weather, news briefs, and system status from a single page.

Named for Argos Panoptes, the hundred-eyed giant of Greek mythology — the all-seeing watcher.

Features

• Task Management — View and manage tasks stored in Obsidian-compatible vault format (Dataview checkbox syntax)
• Calendar Widget — Today's events from CalDAV calendars (via khal/vdirsyncer)
• Weather — Current conditions and forecast
• Morning Brief — Daily news digest display
• System Status — OpenClaw gateway, server uptime, API usage tracking
• Context Log — Daily memory/notes viewer
• File Browser — Browse workspace files
• Tab Navigation — Home, Tasks, Completed, Files, OpenClaw tabs

A Note About "Zag"

You'll see the name "zag" in task file paths, CLI owner names, and configuration. Argos was built for daily use with an AI assistant named Zag (an OpenClaw agent). Where you see "zag," think "agent" or "automation" — it's the owner bucket for tasks the AI handles.

If you're adapting Argos for your own setup, rename it to match your agent or just call it "agent." The CLI reads owner names from the TASK_FILES dict in cli/task — one line to change.

Architecture

Argos is a static web app (HTML/CSS/JS) served by any web server. It reads data from a configurable data directory via HTTP — no build step, no framework, no dependencies.

┌─────────────┐     ┌──────────────┐     ┌─────────────────┐
│   Browser    │────▶│  Web Server  │────▶│  Data Directory  │
│  (Argos UI)  │     │ (Caddy/nginx)│     │ (workspace files)│
└─────────────┘     └──────────────┘     └─────────────────┘

Data is served as static files — task markdown files, JSON status files, calendar data, and briefs. A companion CLI tool handles task CRUD operations on the vault files.

Quick Start

1. Clone and configure

git clone https://github.com/laydros/argos.git
cd argos
cp config.example.json config.json
# Edit config.json with your settings

2. Set up your data directory

Argos expects a data directory with this structure:

data/
├── obnotes/                    # Obsidian vault (or any markdown task files)
│   ├── work/work-tasks.md
│   ├── personal/personal-tasks.md
│   ├── zag/zag-tasks.md        # Agent/automation tasks (rename as needed)
│   └── inbox.md
├── status.json                 # System status (generated by status-update script)
├── calendar-today.json         # Calendar events (generated by calendar-update script)
└── memory/
    └── briefs/                 # Morning brief markdown files

3. Serve with any static server

Caddy (recommended):

:80 {
    handle /data/* {
        uri strip_prefix /data
        root * /path/to/your/workspace
        file_server browse
    }
    handle {
        root * /path/to/argos
        try_files {path} /index.html
        file_server
    }
}

Python (for testing):

python3 -m http.server 8080

4. Use the task CLI

# List all tasks
./cli/task list

# Add a task
./cli/task add --owner work --section Active "Fix the login bug"

# Complete a task
./cli/task done "Fix the login bug"

# Move a task between sections
./cli/task move "Research options" --to Backlog

# Check task file health
./cli/task health

See docs/task-format.md for the full task format specification.

Configuration

Copy config.example.json to config.json and customize:

Field	Description	Default
weatherLocation	City for weather widget	""
openclawToken	OpenClaw API token (optional)	""
vaultPaths.work	Path to work tasks file	/data/obnotes/work/work-tasks.md
vaultPaths.personal	Path to personal tasks file	/data/obnotes/personal/personal-tasks.md
vaultPaths.zag	Path to agent/automation tasks	/data/obnotes/zag/zag-tasks.md
inboxPath	Path to inbox file	/data/obnotes/inbox.md

For the CLI, set ARGOS_VAULT_DIR to point to your vault:

export ARGOS_VAULT_DIR="$HOME/Documents/MyVault"

Task Format

Tasks use Obsidian Dataview checkbox format:

## Active

- [ ] Task title #tag1 #tag2 [due:: 2026-02-15] [project:: MyProject]
  Description or notes on the next line (2-space indent)

- [/] In-progress task [created:: 2026-02-01]

## Backlog

- [ ] Future task [priority:: high]

## Done

- [x] Completed task [done:: 2026-02-05] [created:: 2026-02-01]

Sections: Active → Backlog → Someday → Done States: [ ] todo, [/] in-progress, [x] done Inline fields: [field:: value] (Dataview syntax)

Full format docs: docs/task-format.md

OpenClaw Integration (Optional)

Argos works great as a dashboard for OpenClaw AI assistants:

• Display the OpenClaw tab with gateway status and session info
• Let your AI agent manage tasks via the CLI
• Show morning briefs generated by cron jobs
• Monitor system status updated by scheduled scripts

License

MIT — see LICENSE for details.