Open cards in imdone

Imdone is a simple and powerful kanban board that works on top of a local folder of plain text markdown files or code.

Features

• Open Imdone Card with Keyboard Shortcut: Place your cursor inside a TODO comment and run the Open cards in imdone: Open Imdone Card command.
• Efficient Card Location Detection: Automatically gathers the active file path and line number, generating a link to open Imdone at the exact location.
• Autocomplete for #imdone Tags: Provides autocomplete suggestions for #imdone tags as you type, making it easier to add and manage tasks.

Setup Instructions for the "Open cards in imdone" Obsidian Plugin

The "Open cards in imdone" plugin allows you to integrate the Imdone Kanban board with your Obsidian vault, providing seamless navigation between tasks and notes or source code. Follow these steps to set it up: (or watch the video tutorial)

Step 1: Open Imdone and Configure Settings

1. Launch Imdone: Start Imdone, and if it’s your first time, you’ll see the tutorial project. The default path for the tutorial project is:
   ~/imdone-tutorial (on macOS/Linux) or C:\Users\<YourUsername>\imdone-tutorial (on Windows).
2. Open Settings: Click the ellipsis menu in the top left corner of Imdone, select Settings, and then click Open Project Settings.
3. Configure File Opener:
   • In the Open Files With dropdown, select Obsidian.
   • Check the option Open Obsidian at Card Source Line.
   • Save the settings and exit the settings menu.

Step 2: Set Up an Obsidian Vault for Imdone

1. Open Obsidian: Launch Obsidian.
2. Create a New Vault:
   • Click Open Folder as Vault in the Obsidian vault selection screen.
   • Navigate to the folder where the Imdone tutorial project resides (~/imdone-tutorial) and select it.
3. Enable Community Plugins:
   • Go to Obsidian Settings > Community Plugins.
   • Click Browse and search for "Imdone".
   • Select Open cards in imdone from the list, then click Install and Enable.

Step 3: Configure Hotkeys for Quick Navigation

1. Set Hotkeys:
   • You can set a hotkey under Settings > Hotkeys in Obsidian.
2. Close the Vault Temporarily: Before testing navigation, close the vault to ensure changes take effect.

Step 4: Test the Integration

1. Navigate from Imdone to Obsidian:
   • Open a card in Imdone and click Open File.
   • Obsidian should open directly to the line of the card's source in the corresponding file.
2. Navigate from Obsidian to Imdone:
   • Place the cursor on a line with an Imdone card reference and press Ctrl+Shift+I (or your configured hotkey).
   • This should bring you back to the card in Imdone.

Step 5: Using Topics in Imdone

1. Create a Topic:
   • In Imdone or Obsidian, create a topic by surrounding a phrase with double brackets, e.g., [[Project Board]].
2. Jump to the Topic:
   • In Imdone, clicking the topic link will jump directly to the topic in Obsidian

Tips for an Integrated Workflow

• Your Imdone Kanban board and Obsidian vault both operate on the same folder, ensuring all files, tasks, and topics remain in sync.
• This setup is perfect for developers who use Markdown and want a seamless way to manage tasks inline with their code or notes.

Imdone vs. Obsidian Kanban Plugin

Both Imdone and the Obsidian Kanban Plugin are powerful tools for task management. While the Obsidian Kanban Plugin is ideal for visual organization within notes, Imdone stands out for developers by embedding tasks directly into code or content workflows.

Core Concept

Key Features

Workflow Comparison

Strengths

Imdone

• Built for developers and technical writers who need tasks directly integrated with their workflows.
• Offers seamless context switching by linking tasks inline with files.
• Highly customizable with plugins, themes, and actions to fit developer-centric workflows.
• Perfect for version-controlled environments, allowing tasks to be tracked and managed alongside code or content.

Obsidian Kanban Plugin

• Designed for users who need a visual task management tool within their note-taking environment.
• Fully integrates with Obsidian’s Markdown-based ecosystem, making it easy to connect tasks with notes.
• Flexible customization options within Obsidian for personal productivity.

Why Developers Choose Imdone

Imdone uniquely embeds task management into your development workflow. By combining a fully functional Kanban board with inline tasks in your files, Imdone reduces context switching and keeps your work seamlessly organized. This makes it the ideal choice for developers who value efficiency and version control.

Changelog

1.1.0

• Update readme with better setup instructions
• Don't set hotkeys
• Fix scroll to line

1.0.5

• Fix windows bugs

1.0.4

• Switched to Ctrl+Shift+I to avoid conflicts with other plugins and align with Imdone code companion for VS Code

1.0.3

• Fix open in obsidian to Line on windows