AI AgentsClaude, Codex & Cursor

Docs v0.1.0•Agent-first CLI

upd is designed to be driven by AI assistants on your behalf. On first upd init, a global skill file is installed so Cursor, Claude Code, or Codex know exactly which commands to run when you ask for your daily update.

Prerequisite: the global upd command must work from any directory. Follow Getting Started steps 2–3 (node bin/upd.js install → upd --get-ai-engines --json) before agents rely on these commands.

Installed skill locations

~/.cursor/skills/upd/SKILL.md
~/.agents/skills/upd/SKILL.md

Discovery commands

Before generating an update, an agent can inspect what is available on the user's machine. Always pass --json and --yes so output is parseable and non-interactive.

upd get-ai-engines --json upd get-destinations --json upd status --json # Root-level aliases (same behavior): upd --get-ai-engines --json upd --get-destinations --json

Prepare → review → send

The recommended flow separates generation from delivery. Drafts are saved per day so the user can edit before anything is posted to Slack.

# 1. Generate from git + AI, save to daily history upd prepare --yes --json upd prepare --period 2 --ai claude --yes --json # 2. Show saved draft (user may edit the file) upd show today --json # 3. Send without regenerating upd send slack --date today --yes --json upd --send slack --update today --yes --json

Daily drafts: ~/.config/upd-cli/updates/YYYY-MM-DD.md (path may vary slightly by OS).

Global flags

Flag	Description
-p, --period <days>	Git scan window (overrides config default)
--ai <engine>	codex, claude, gemini, grok, ollama, custom
--json	JSON stdout for agents
-y, --yes	Non-interactive (required for agents)
--save	Save draft during interactive upd
--send <dest>	Send saved draft: slack or clipboard
--update <date>	today, yesterday, or YYYY-MM-DD

All commands

Command	Description
upd	Interactive standup (or prepare when --yes)
upd init	Setup wizard + install agent skill
upd install	Global shell alias + npm link
upd prepare	Generate and save daily draft
upd show [date]	Read saved draft
upd send <dest>	Send saved draft to slack / clipboard
upd generate	Same as upd with explicit flags
upd settings	Interactive configuration
upd get-ai-engines	List AI engines
upd get-destinations	List delivery targets
upd status	Config summary

Rules for agents

Always use --yes and --json when running on behalf of the user.
Do not run git commands for standup content — upd extracts commits internally.
Run upd prepare before upd send unless a draft for that date already exists.
Show the draft to the user after prepare; only send to Slack after they approve.

PreviousSettings & AI NextHow It Works