task-setup

Task Setup

Configure the current project for the Task Manager plugin and agent skills.

What this does

1. Resolves the task directory and creates it with tasks.json if missing
2. Copies task-cli.sh if missing
3. For Claude Code, creates or updates .claude/settings.local.json with permissions for task management paths

Steps

1. Resolve and initialize task directory

Resolve TASKS_DIR:

1. If TASK_MANAGER_TASKS_DIR is set, use that.
2. Else if .claude/tasks exists, use .claude/tasks for backward compatibility.
3. Else if .agents/tasks exists, use .agents/tasks.
4. Else if .kiro/tasks exists, use .kiro/tasks.
5. Else if .idea/agents-tasks exists, use .idea/agents-tasks.
6. Else if TASK_MANAGER_AGENT=codex or you are running in Codex, use .agents/tasks; if TASK_MANAGER_AGENT=kiro-cli or you are running in Kiro, use .kiro/tasks; otherwise use .claude/tasks.

mkdir -p "$TASKS_DIR/docs"

If $TASKS_DIR/tasks.json doesn't exist, create it:

{"groups": []}

2. Install task-cli.sh

If $TASKS_DIR/task-cli.sh doesn't exist, check if it's available at:

• scripts/task-cli.sh (in current project, if this is the plugin repo)
• The global skills directory

If found, copy it and make executable. If not found, inform the user they need to install the Task Manager plugin skills first.

3. Configure Claude permissions when applicable

If you are running in Claude Code, read .claude/settings.local.json if it exists. Merge the following permissions into the existing allow array (don't replace existing rules):

{
  "permissions": {
    "allow": [
      "Bash(bash .claude/tasks/task-cli.sh:*)",
      "Bash(bash .agents/tasks/task-cli.sh:*)",
      "Bash(bash .kiro/tasks/task-cli.sh:*)",
      "Bash(bash .idea/agents-tasks/task-cli.sh:*)",
      "Bash(git log:*)",
      "Bash(git rev-parse:*)",
      "Bash(git add:*)",
      "Bash(git commit:*)",
      "Bash(git diff:*)",
      "Bash(git status:*)",
      "Read(.claude/tasks/**)",
      "Edit(.claude/tasks/**)",
      "Write(.claude/tasks/**)",
      "Read(.agents/tasks/**)",
      "Edit(.agents/tasks/**)",
      "Write(.agents/tasks/**)",
      "Read(.kiro/tasks/**)",
      "Edit(.kiro/tasks/**)",
      "Write(.kiro/tasks/**)",
      "Read(.idea/agents-tasks/**)",
      "Edit(.idea/agents-tasks/**)",
      "Write(.idea/agents-tasks/**)"
    ]
  }
}