Skip to content

Refresh README for automations, reminders, variables, and MCP - #253

Open
steezeburger wants to merge 4 commits into
mainfrom
claude/readme-refresh-automations-mcp
Open

steezeburger wants to merge 4 commits into
mainfrom
claude/readme-refresh-automations-mcp

Conversation

@steezeburger

Copy link
Copy Markdown
Owner

Promotes automations into their own section with real, verified syntax (trigger cadences, query DSL, verb list, allow::, for::), splits reminders out from scheduling, adds a Variables section for {{token}} syntax and custom variables, and lightly touches up MCP. All examples were fact-checked against the current code (automation_spec.py, automation_actions.py, content_tokens.py, mcp_server/tools.py) and three real screenshots were added and referenced inline, captured against a locally-bootstrapped instance.

Also fixes a small CSS bug noticed along the way: .inline-tag/.inline-property-value chips had no line-height headroom, so a multiline #automation block (a chip at the start of every line) rendered as one visually-connected block instead of separate lines.

🤖 Generated with Claude Code

https://claude.ai/code/session_018yMA39rVbEJzFYZvH8mQCZ


Generated by Claude Code

These are the most-used features day to day, but the README still
framed automations as "where it's headed" even though triggers, the
query DSL, the verb vocabulary, for:: iteration, and variables are all
shipped. Give automations, reminders, and variables their own
sections with real syntax examples, and trim "Where it's headed" down
to what's actually still unbuilt (the reactive slice, action
chaining, webhooks, the widget layer).
Fact-checked the prior rewrite against the actual code and fixed three
real bugs it introduced: `weekly tue,thu 5:30` isn't valid syntax (the
weekly cadence only takes one weekday — switched the headline example to
the `cron` escape hatch, which does support a multi-day dow field);
`notify "..." on match` silently ignores "on match" (notify only reads
its first arg) rather than gating on it; and `for:: 1..5` doesn't parse
without an explicit `by <step>`. Also corrected the MCP tool count (16 →
18, counted from mcp_server/tools.py's registry) and clarified the
`every` cadence's actual `Nm`/`Nh` syntax. The five in-flight issues the
prior session flagged as still unmerged (#206, #217, #225, #236, #250)
are all still open on main, so "Where it's headed" needed no changes.

Added three real screenshots (docs/images/screenshot{4,5,6}.png), taken
against a locally-bootstrapped instance (no Docker daemon in this
sandbox, so used the .ai/PROJECT_SETUP.md hybrid fallback) with seeded
example content matching the README's own prose: the corrected
automation block, the Overdue saved view embedded on a page, and the
chat panel mid-conversation running a query tool. Skipped the Discord
reminder screenshot since no webhook is configured in this sandbox and
faking one didn't seem worth it.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018yMA39rVbEJzFYZvH8mQCZ
Vertical padding on an inline element doesn't grow its line box, so on
multiline content where a highlighted chip sits at the start of every
line (a multi-property automation definition: trigger::/query::/
action::), adjacent chips' backgrounds visually touched with no gap,
reading as one connected block instead of separate lines. Giving
.inline-tag and .inline-property-value their own taller line-height
grows just the line box they're on, without affecting ordinary prose
lines that don't contain a chip.

Re-captured the three README screenshots against the fix.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018yMA39rVbEJzFYZvH8mQCZ
@steezeburger steezeburger added no-staging Skip staging deploys for this PR (leaves any running env alone) teardown-staging Tear down this PR's staging env now and keep it down labels Sep 30, 2026 — with Claude

Copy link
Copy Markdown
Owner Author

Deploy to Staging failed (exit 137, OOM-killed mid-migrate — see run). Not this PR's failure: the diff here is README + a CSS line-height tweak, no migrations or app code touched, and this is exactly the job this PR asked to skip via the no-staging label. It only ran because GitHub evaluates the deploy condition against the PR's labels at event time, and no-staging landed a few seconds after the opened event had already fired.

I added teardown-staging right after, which queued behind the in-flight deploy and cleanly tore it down once it failed (see the successful Teardown Staging run) — no dangling environment. Not re-running the deploy, since re-running it would just redeploy to staging, which is the opposite of what no-staging is asking for here. ci is green and the PR is otherwise mergeable.


Generated by Claude Code

@steezeburger steezeburger removed the teardown-staging Tear down this PR's staging env now and keep it down label Sep 30, 2026 — with Claude
…ase properties, drop chat screenshot

- Swap the line-height increase for a smaller vertical padding on
  .inline-tag/.inline-property-value. Growing line-height also widened
  the gap around ordinary text on any line that mixed prose with a
  chip; shrinking the chip's own box instead leaves normal text
  spacing untouched and only opens up room between stacked chips.
- Replace the automation query example's `tag:priority` with
  `prop:priority=high` (and the matching `priority:: high` property on
  the seeded Roadmap todos, replacing the #priority tag) — better
  showcases the property query predicate, which the feature is more
  distinctively about than a plain hashtag.
- Drop the in-app-chat screenshot; that section doesn't need the same
  visual emphasis as automations/reminders/variables/MCP.

Re-captured screenshot4/5 against these changes; screenshot6 removed.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018yMA39rVbEJzFYZvH8mQCZ

This branch was successfully deployed

1 active (outdated) deployment
ci — dd8828bd Deployed Sep 30, 2026 by steezeburger via Teardown Staging #767
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

no-staging Skip staging deploys for this PR (leaves any running env alone)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants