karea_create_task
Create a new task in a project with a required title and optional fields like deadline, priority, category, and markdown. The task gets a visual ID and returns its status, priority, and category.
Instructions
Create a new task in a project and return it with its visual ID (e.g. KA42), status, priority and category. Defaults when omitted: status open, priority 3, the first category of the project. Use karea_quick_task to log something already finished, or karea_doing for work in progress.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sla | No | Deadline: 2d, 5h, tomorrow, monday | |
| name | Yes | Task title | |
| tags | No | Tags to attach. STRICT: only pass tags that already exist in this project (verify with karea_view_task or the project list). Do NOT invent new tags unless the user explicitly asked for one — a typo or a paraphrase spawns duplicate tags. When unsure, omit and ask the user. | |
| source | No | Where this task came from | |
| category | No | Category name | |
| markdown | No | Long-form markdown content — use for investigation findings, technical/functional docs, solution design, root cause analysis. This is the task's knowledge base. | |
| parentId | No | Parent task ID to create this as a subtask | |
| priority | No | Priority 1-5 (1=critical) | |
| toolType | No | Optional: your AI provider ("claude-code" / "opencode" / "codex" / "cursor" / "aider" / "other"). Required when aiSessionId is supplied. | |
| projectId | No | Project name or ID | |
| aiSessionId | No | Optional: your current AI CLI session ID. When paired with toolType, atomically links this session to the affected task (equivalent to calling karea_link_session, but saves the round-trip). For Claude Code use the id from `claude --resume`. | |
| description | No | Task description. Rendered as Markdown - use `**bold**`, lists, `code`, links, etc. Keep it short (a few sentences); use `markdown` for long-form docs. | |
| jiraIssueKey | No | JIRA issue key to link (e.g. PROJ-123). Issue must exist in JIRA. | |
| sessionLabel | No | Optional short label for the linked session (e.g. "Feature draft"). | |
| closingRequisites | No | Requirements that must be met before closing. Keep each one short and concrete - 1 short sentence, ideally under ~120 chars (e.g. "Tests pass in CI", "PR approved"). Do NOT write paragraphs. |