antara (अन्तर) - Sanskrit for interval, space, or gap
Tune the rhythms of life.
Requires Deno v2.0+
git clone https://github.com/zan/antara.git
cd antara
deno task installThis installs antara globally via deno install. The database is created automatically on first run (~/.antara/db.sqlite).
Defines when something should happen. Three variants:
| Variant | Description | Example |
|---|---|---|
| Trailing | Sliding window from now | "5x in the last 7 days" |
| Recurring | Resets from last completion | "Every 30 days" |
| Calendar | Fixed calendar periods | "3x per week" |
A recurring pattern you track. Has two framings:
| Framing | Mindset | Typical Rhythm | Example |
|---|---|---|---|
| Task | Maintenance | Recurring | Clean bathroom every 30 days |
| Pursuit | Growth | Any | Climb 3x per week, drums 150min/week |
How progress is counted:
- Instances — Count occurrences (each completion = 1)
- Duration — Accumulate minutes
Tasks always use instances. Pursuits can use either.
One-off tasks with no rhythm. Due immediately upon creation. Completed errands remain visible for 3 days, then fade from view.
antara errand add # Add a new errand
antara errand # List errands
antara errand done # Mark an errand completeErrands also appear in antara status.
| Command | Description |
|---|---|
antara status |
Show progress for all activities |
antara log [name] |
Log a completion or duration |
antara history [-n N] |
Show recent activity events (default: 15) |
antara create |
Create a new activity |
antara edit |
Edit an existing activity |
antara errand |
Manage one-off errands |
deno task install:zsh-completionsThen add to ~/.zshrc (before compinit):
fpath=(~/.zsh/completions $fpath)Restart your shell. Tab-completion works for subcommands (antara <tab>) and activity names (antara log <tab>).
deno install # Install dependencies
deno task db:generate # Generate migrations from schema
deno task db:migrate # Apply migrations
deno task check # Type check
deno task test # Run tests
deno task biome # Lint and format
deno task dev # Run CLI (dev mode with watch)
deno task cli # Run CLIMIT