# Daily Checkbox Focus

Daily Checkbox Focus is a small Obsidian plugin that moves the editor cursor to the first empty checkbox in the top capture area when you open a daily note.

It is intended for daily notes where the first empty top checkbox is the next place you want to type.

## What it does

- Detects daily notes by filename: `YYYY-MM-DD.md`.
- Works no matter which folder contains the daily note, for example `Alfa/WRK/2026-05-19.md`.
- On open, jumps once to the first truly empty checkbox line in the top capture area:
  - `- [ ] `
  - `* [ ] `
  - `+ [ ] `
- Inserts one missing empty checkbox in the top capture area when that setting is enabled.
- Places the cursor after the checkbox marker and at least one following space.
- Provides manual commands for the active Markdown file:
  - `Jump to first empty checkbox`
  - `Debug first empty checkbox`

## Top capture area

The top capture area starts at the beginning of the file, after optional YAML frontmatter, and ends before the first Markdown heading:

```md
---
date: 2026-05-20
---

- [ ]

# Work
```

The plugin only searches this area. It never focuses empty checkboxes below the first heading, so sections such as `# Work`, `## Todo.Family`, `# Life`, or `# Hobbies` are left alone.

## How it works

When a Markdown file opens, the plugin checks whether the filename matches `YYYY-MM-DD.md`. If it does, the plugin briefly retries while Obsidian finishes loading the editor, then moves the cursor to the first empty checkbox line it can safely use in the top capture area.

If there is no truly empty checkbox before the first heading and `Create missing top checkbox` is enabled, the plugin inserts one empty checkbox immediately before the first heading and keeps one blank line before that heading. If the note has YAML frontmatter and no content before the first heading, the checkbox is inserted after the frontmatter.

The automatic jump runs at most once for each file-open session. If you start typing after opening the note, pending automatic jumps are cancelled so your editing is not interrupted.

The plugin ignores empty checkboxes inside fenced code blocks, including `tasks` code blocks, and ignores callout or blockquote lines that start with `>`.

## Settings

- `Create missing top checkbox`: enabled by default. When enabled, the plugin inserts one empty checkbox in the top capture area if none exists. When disabled, the plugin only focuses an existing empty checkbox.
- `Focus on open`: enabled by default. When disabled, automatic focus on daily-note open is turned off, but the manual command still works.

## Installation

1. Open Obsidian settings.
2. Go to `Community plugins`.
3. Choose `Browse`.
4. Search for `Daily Checkbox Focus`.
5. Install and enable the plugin.

## Manual installation

You can also install a release manually:

1. Download `main.js` and `manifest.json` from the GitHub release.
2. In your vault, create `.obsidian/plugins/daily-checkbox-focus/`.
3. Put `main.js` and `manifest.json` in that folder.
4. Restart Obsidian or reload plugins.
5. Enable `Daily Checkbox Focus` in `Community plugins`.

## Troubleshooting

- Confirm your daily note filename is exactly `YYYY-MM-DD.md`, such as `2026-05-19.md`.
- Confirm the target checkbox is before the first Markdown heading and has no text after it. `- [ ] ` works; `- [ ] something` is intentionally skipped.
- Confirm the checkbox is not inside a fenced code block and is not in a callout or blockquote line.
- Check `Create missing top checkbox` if you expect the plugin to insert a missing top checkbox.
- Run `Debug first empty checkbox` from the command palette to see the current file path, daily-note match status, top capture range, session state, detected target, and nearby top-capture lines containing `[ ]`.
- Open the developer console if you need the structured debug log.

## Privacy and safety

Daily Checkbox Focus does not send data anywhere. It does not use network requests, Node.js APIs, or Electron APIs. It only reads the currently open editor content enough to find or insert a top capture checkbox and move the editor cursor.

## Limitations

- Automatic focus only runs for files named `YYYY-MM-DD.md`.
- The daily note may be in any folder, but the filename must match that date format.
- The plugin may insert one empty checkbox in the top capture area when `Create missing top checkbox` is enabled.
- The plugin does not change Tasks plugin settings or depend on the Tasks plugin.

## Compatibility

- Minimum Obsidian version: `1.0.0`.
- Desktop-only: no. The plugin does not use Node.js or Electron APIs, so `isDesktopOnly` is `false`.

## Releases

Release tags should match the plugin version exactly. For version `1.1.1`, create and push the tag `1.1.1`.