GTD Next Action for Kamyanytsya

This Obsidian plugin implements GTD (Getting Things Done) Next Action functionality as part of the Kamyanytsya Productivity System. It allows you to track and manage next actions across multiple files in your vault.

Features

• Multi-file tracking: Find and display next actions from all files with the same name across your vault
• Checkbox management: Automatically detects checkbox groups and displays the first unchecked item from each group
• Priority system: Color-coded priority levels (#priority1-5) with background highlighting
• Flag system: Visual flag indicators (#flag1-5) with colored circle emojis
• Smart filtering: Automatically hides files marked with #draft or files with all checkboxes completed
• Interactive sorting: Sort by default order, priority, or flag level (ascending/descending)
• Click-to-open: Click on row headers to open the corresponding file
• Live updates: Table automatically refreshes when files are opened or tabs become active
• Checkbox toggling: Click checkboxes directly in the table to update files

Installation

From Obsidian Community Plugins

1. Open Obsidian Settings
2. Go to Community plugins
3. Search for "GTD Next Action for Kamyanytsya"
4. Click Install and then Enable

Manual Installation

1. Download the latest release from the Releases page
2. Extract the files to your vault's .obsidian/plugins/kamyanytsya__next_action__obsidian_plugin/ folder
3. Reload Obsidian
4. Enable the plugin in Settings → Community plugins

Usage

Basic Usage

In any markdown file, create a code block with the file name you want to track:

```next_action__kamyanytsya
MyProject
```

The plugin will:

• Find all files named "MyProject" (without extension) in your vault
• Display them in an interactive table
• Show the first unchecked checkbox from each checkbox group
• Filter out files with #draft or all checkboxes completed

Priority System

Add priority tags to your files to control background colors:

• #priority1 - Transparent background (default)
• #priority2 - Light blue background
• #priority3 - Yellow background
• #priority4 - Orange background
• #priority5 - Red background

Flag System

Add flag tags to show visual indicators:

• #flag1 - ⚪ Transparent circle
• #flag2 - 🔵 Blue circle
• #flag3 - 🟡 Yellow circle
• #flag4 - 🟠 Orange circle
• #flag5 - 🔴 Red circle

Sorting

Use the sort buttons above the table:

• Default: Shows files in the order they were found
• Priority: Sorts by priority level (default: descending, #priority5 to #priority1)
• Flag: Sorts by flag level (default: descending, #flag5 to #flag1)

Click the same button again to toggle between ascending (↑) and descending (↓) order.

Checkbox Groups

The plugin automatically detects checkbox groups. A group is defined as consecutive checkboxes. When a non-checkbox line appears, it starts a new group.

Example:

- [ ] First task in group 1
- [ ] Second task in group 1
- [x] Completed task in group 1

Some text here starts a new group

- [ ] First task in group 2
- [x] Completed task in group 2

The plugin will show the first unchecked checkbox from each group.

Requirements

• Obsidian v0.15.0 or higher

Development

Setup

npm install

Development Build

npm run dev

Production Build

npm run build

Linting

npm run lint

Architecture

This plugin follows SOLID principles:

• Single Responsibility: Each class has one clear purpose
• Open/Closed: Sorting strategies can be extended without modification
• Liskov Substitution: All sorters implement the same interface
• Interface Segregation: Focused, minimal interfaces
• Dependency Inversion: Components depend on abstractions, not concrete implementations

License

MIT License

Author

Volodymyr5

Support

For issues, feature requests, or contributions, please visit the GitHub repository.