keep now

Get or set the current working intentions.

The nowdoc is a singleton document that tracks what you're working on right now. It has full version history, so previous intentions are always accessible.

Usage

keep now                              # Show current intentions
keep now "Working on auth flow"       # Update intentions
keep now "Auth work" -t project=myapp # Update with tag
echo "piped content" | keep now       # Set from stdin

Options

Option	Description
`-t`, `--tag KEY=VALUE`	Set tag on the update (repeatable)
`--truncate`	Truncate content to `max_inline_length` instead of failing

Version history

The nowdoc retains full history. Each update creates a new version. See VERSIONING.md for details.

Similar items and meta sections

When updating (keep now "..."), the output surfaces similar items and meta sections as occasions for reflection:

---
id: now
tags:
  project: "myapp"
  topic: "auth"
similar:
  - %a1b2c3d4 OAuth2 token refresh pattern...
meta/todo:
  - %e5f6a7b8 validate redirect URIs
meta/learnings:
  - %c9d0e1f2 Token refresh needs clock sync
---
Working on auth flow

keep move

When a string of work is complete, move the now history into a named note. Requires either -t (tag filter) or --only (cherry-pick the tip).

keep move "auth-string" -t project=myapp   # Move matching versions
keep move "quick-note" --only              # Move just the current version

Moving to an existing name appends incrementally. Use --from to reorganize between items. See KEEP-MOVE.md for details.

keep prompt reflect

Deep structured reflection practice. Guides you through gathering context, examining actions, and updating intentions.

keep prompt reflect                       # Reflect on current work
keep prompt reflect "auth flow"           # Reflect with search context
keep prompt reflect --since P7D           # With time filter

See KEEP-PROMPT.md for full prompt options including --id, --tag, --since, --until.