Iter

by mateusdcc
5
4
3
2
1
Score: 50/100

Description

An Obsidian habit and goal tracker. Grow a goal garden, water recurring habits, and build dashboards from your vault notes.

Reviews

No reviews yet.

Stats

0
stars
22
downloads
0
forks
4
days
4
days
4
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
23
commits

Latest Version

5 days ago

Changelog

Updates the plugin description to meet the Obsidian Community directory requirements.

README file from

Github

Iter for Obsidian

Grow a garden of goals inside your Obsidian vault. Give each long-term goal a tree, break it into milestones, and water it by completing the habits that support it. Build dashboards from the notes and numbers you already keep in Obsidian.

Install Iter · Documentation · Releases · Contribute

CI MIT license

The Iter sidebar beside We Garden, with a watering queue and three trees at different stages of growth

What you can do

  • Set up a tree for Reading, Japanese, or Gym. Give it a target date or keep it ongoing.
  • Water recurring habits on daily, selected-day, weekly, or monthly schedules. The We Garden shows today's queue and how each tree is growing.
  • Build dashboards with streaks, progress bars, charts, and linked notes. Pull numeric properties such as pages or exam scores from Obsidian notes and combine datasets across a tree.
  • Put a live widget or today's habit tracker inside a Markdown note. Use the visual Canvas widget editor to filter, combine, or summarize data for a custom widget.

Installation

Requires Obsidian 1.14.5 or later. Install Iter in each vault where you want to use it.

Install from Obsidian Community Plugins

  1. In Obsidian, go to Settings → Community plugins and turn on community plugins if prompted.
  2. Select Browse, search for Iter, and open its listing.
  3. Select Install, then Enable.

You can also open the Iter listing and select Add to Obsidian.

Install with BRAT

  1. Open Settings → Community plugins → Browse. Turn on community plugins if prompted, then install and enable BRAT (Beta Reviewer's Auto-update Tool).
  2. Open the command palette and run BRAT: Add a beta plugin for testing, or choose Add beta plugin in BRAT settings.
  3. Paste https://github.com/mateusdcc/obsidian-iter. Choose Latest version if prompted, then select Add Plugin.
  4. In Settings → Community plugins, enable Iter if BRAT left it disabled.

BRAT can check for updates from the repository. To pin a version, use BRAT's option to select a release tag during setup.

  1. Download main.js, manifest.json, and styles.css from the same GitHub release.
  2. Put all three files in .obsidian/plugins/iter/ inside your vault.
  3. Reload Obsidian and enable Iter under Settings → Community plugins.

Start a garden

  1. In the command palette, run Iter: Create tree and name it Reading.
  2. Run Iter: Create habit, select Reading, and create a daily Read 10 pages habit. Add Finish a book with Iter: Create subgoal.
  3. Run Iter: Open We garden. Select Water when you complete the habit, and open the tree to review its progress.
  4. Open a goal or habit and use Add data and Add widget to build a dashboard. Follow the worked examples for linked note properties and time graphs.

Iter creates an Iter/ folder in your vault. Goals, schedules, watering history, datasets, and widget configuration live in Markdown and YAML frontmatter. Back up or sync the folder with the rest of your vault, including any source notes your datasets link to.

Screenshots

Iter panel

Browse your trees, subgoals, and scheduled habits in the Obsidian sidebar.

Bench 80 kg

Use a dated workout log to chart your lifts and track progress toward a target weight.

Bench 80 kg dashboard showing a chart from 20 to 30 kg, a progress bar at 38%, and the dated workout entries

Reading habit

Schedule a habit for specific days and see its streak alongside a pages-read total.

Reading habit dashboard with Tuesday, Thursday, and Saturday selected, plus Pages Read and Streak widgets

Development

Use Node.js 24 and npm.

npm ci
npm test
npm run build

See CONTRIBUTING.md for a test vault setup, release steps, and how to edit the docs. Report bugs or share ideas via GitHub Issues. See SECURITY.md for private security reports.

Iter is released under the MIT License.