Passing Issues

Emdash can create tasks directly from issues. Select an issue in the Create Task modal, choose the branch to start from, and Emdash links the issue to the task so it is available as conversation context.

Create from an Issue

1. Click Add Task or press ⌘N
2. Select From Issue
3. Search for an issue and select it
4. Choose the branch to start from
5. Enter a task name or use the generated name
6. Select a provider
7. Click Create

The linked issue stays attached to the task and can be inserted into conversations as context. When inserted, Emdash includes the provider, identifier, title, URL, description, status, assignees, and project when those fields are available.

Branch and Worktree

Issue tasks use the same branch and worktree controls as branch-based tasks. By default, Emdash creates a task branch and worktree from the selected branch; you can also work directly on your checked out branch when you disable worktree creation.

For Linear issues with a branch name, Emdash can use Linear's branch name for the generated task name and task branch. Other issue providers use Emdash's normal task name and branch generation.

Supported Trackers

Emdash supports:

• Linear
• Asana
• Monday.com
• Trello
• GitHub Issues
• Jira
• GitLab
• Plane work items
• Forgejo
• Featurebase posts
• Plain threads

Missing your tracker? Open an issue or message us on Discord.

Connecting Your Tracker

Go to Settings -> Integrations to connect the tracker you use. GitHub Issues uses the GitHub account selected for the project. See GitHub Accounts to connect accounts and choose the account a project should use.

Linear

1. Go to Linear Settings → Security & access → Personal API keys
2. Create a new API key
3. Paste the key in Emdash and click Connect

Asana

1. In Asana, click your profile photo → My Settings → Apps
2. Open Developer apps and create a personal access token
3. Paste the token in Emdash and click Connect

When browsing issues, Emdash shows incomplete Asana tasks assigned to you from your primary workspace. Search uses Asana's task search for incomplete tasks in that workspace.

Trello

1. Open Trello Power-Ups admin
2. Create a Power-Up and copy its API key
3. Generate an API token from the API key page
4. In Emdash, paste the API key and API token
5. Optionally add one or more board URLs, separated by commas or new lines
6. Click Connect

Emdash lists and searches open Trello cards. If you add board URLs, Emdash searches only those boards; otherwise it searches the first 20 open boards available to your Trello account. When a card is attached to a task, Emdash includes the card description, board, checklists, and comments when those fields are available.

Monday.com

1. Open the monday.com Developer Center API token tab
2. Copy your API token
3. In Emdash, paste the token and add one or more board URLs
4. Click Connect

Emdash lists and searches items from the connected boards. When an item is attached to a task, Emdash includes the item details, Monday Docs description content, and recent updates when those fields are available.

Jira

1. Go to Atlassian Account Settings → Security → API Tokens
2. Create a new API token
3. In Emdash, enter your site URL (e.g., https://yourcompany.atlassian.net), email, and token
4. Click Connect

GitHub Issues

To use GitHub Issues:

1. Go to Settings -> Integrations -> GitHub
2. Add a GitHub account with Emdash account / OAuth, GitHub CLI import, or device flow
3. Open Project Settings and choose that account under GitHub account

GitLab

1. In GitLab, go to User Settings → Access Tokens and create a personal access token with the read_api scope
2. In Emdash, enter your GitLab instance URL and token
3. Click Connect

Plane

1. In Plane, go to Profile Settings → Personal Access Tokens and create a token
2. In Emdash, enter your Plane API base URL, workspace slug, and API key. For Plane Cloud, keep the default API base URL (https://api.plane.so); for self-hosted Plane, enter your instance API base URL, for example https://plane.example.com
3. Click Connect

Emdash lists and searches Plane work items. When a work item is attached to a task, Emdash includes its identifier, title, URL, description, status, assignees, project, priority, and labels when those fields are available.

Forgejo

1. In Forgejo, go to Settings → Applications and generate a token with the read:issue scope
2. In Emdash, enter your Forgejo instance URL and token
3. Click Connect

Featurebase

1. In Featurebase, go to Settings → Integrations → API and create an API key
2. Paste the key in Emdash and click Connect

Plain

1. In Plain, go to Settings → API keys and create an API key that can read threads
2. Paste the key in Emdash and click Connect