Help · How to
File a task on GitHub
The subject must be a project with a linked repository.
- Open the task: in MINE, or on the subject's Tasks pane.
- Choose File on GitHub from the row's menu. On the web, the open task has it too.
- The task becomes an issue on the repository, with a link back to the task. The task and the issue stay one card. The board sets the card's column from the issue's
agent:*labels.
To start from an issue instead, use New Issue (⌥⌘I) on the subject.
Star the task or issue from its Work row to keep it in Starred. This does not change its issue state or board column.
Where it works
| Capability | macOS Host | macOS Join | Web | iOS / iPadOS | Agent access |
|---|---|---|---|---|---|
| Projects and leads, with their tasks and issues | Works | Works | Works | Works | search (MCP), open (MCP), task (MCP), record_decision (MCP), set_goal (MCP), meet://subject/{kind}/{id}, meet://subjects/{kind}, meet://board/{days}, /api/crm/tasks, /api/crm/mine, /api/crm/recently-closed, /api/crm/unowned, /api/crm/goals, /api/crm/decisions, /api/crm/subjects, /api/crm/organizations |
| Issues that read like GitHub's own | Works | Works | Partial | Works | create_issue (MCP), /api/crm/issue |
Verified · docs/help/howto/file-a-task-on-github.md