Skip to content
LumenFlow

Sidekick Tools

This page is generated by pnpm docs:generate:pack-reference. Add any pack-specific notes outside the managed block below; reruns preserve them.

The generated Required approvals: None values report static manifest metadata. Runtime policy separately requires explicit approval for sidekick-task:cancel, memory:forget, channel:delete, and routine:delete.

Tool Summary

Section titled “Tool Summary”
ToolPermissionRequired approvalsRequired scopes
sidekick-task:createwriteNonepath read .sidekick/**
path write .sidekick/**
sidekick-task:listreadNonepath read .sidekick/**
sidekick-task:updatewriteNonepath read .sidekick/**
path write .sidekick/**
sidekick-task:canceladminNonepath read .sidekick/**
path write .sidekick/**
sidekick-task:completewriteNonepath read .sidekick/**
path write .sidekick/**
sidekick-task:schedulewriteNonepath read .sidekick/**
path write .sidekick/**
memory:storewriteNonepath read .sidekick/**
path write .sidekick/**
memory:recallreadNonepath read .sidekick/**
memory:forgetadminNonepath read .sidekick/**
path write .sidekick/**
memory:updatewriteNonepath read .sidekick/**
path write .sidekick/**
channel:configurewriteNonepath read .sidekick/**
path write .sidekick/**
channel:listreadNonepath read .sidekick/**
channel:deleteadminNonepath read .sidekick/**
path write .sidekick/**
channel:sendwriteNonepath read .sidekick/**
path write .sidekick/**
channel:receivereadNonepath read .sidekick/**
routine:createwriteNonepath read .sidekick/**
path write .sidekick/**
routine:listreadNonepath read .sidekick/**
routine:updatewriteNonepath read .sidekick/**
path write .sidekick/**
routine:deleteadminNonepath read .sidekick/**
path write .sidekick/**
routine:runreadNonepath read .sidekick/**
sidekick:routine:commit_planwriteNonepath read .sidekick/**
path write .sidekick/**
sidekick:initwriteNonepath read .sidekick/**
path write .sidekick/**
sidekick:statusreadNonepath read .sidekick/**
sidekick:exportreadNonepath read .sidekick/**

Tool Details

Section titled “Tool Details”

sidekick-task:create

Section titled “sidekick-task:create”
  • Permission: write
  • Required approvals: None
  • Required scopes: path read .sidekick/**, path write .sidekick/**

Input schema

Section titled “Input schema”
{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "minLength": 1
    },
    "description": {
      "type": "string"
    },
    "priority": {
      "type": "string",
      "enum": ["P0", "P1", "P2", "P3"]
    },
    "due_at": {
      "type": "string"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "dry_run": {
      "type": "boolean"
    }
  },
  "required": ["title"],
  "additionalProperties": false
}

Output schema

Section titled “Output schema”
{
  "type": "object",
  "additionalProperties": true
}

sidekick-task:list

Section titled “sidekick-task:list”
  • Permission: read
  • Required approvals: None
  • Required scopes: path read .sidekick/**

Input schema

Section titled “Input schema”
{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": ["pending", "done", "canceled"]
    },
    "priority": {
      "type": "string",
      "enum": ["P0", "P1", "P2", "P3"]
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "search": {
      "type": "string"
    },
    "due_before": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "minimum": 1
    }
  },
  "additionalProperties": false
}

Output schema

Section titled “Output schema”
{
  "type": "object",
  "additionalProperties": true
}

sidekick-task:update

Section titled “sidekick-task:update”
  • Permission: write
  • Required approvals: None
  • Required scopes: path read .sidekick/**, path write .sidekick/**

Input schema

Section titled “Input schema”
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1
    },
    "title": {
      "type": "string",
      "minLength": 1
    },
    "description": {
      "type": "string"
    },
    "priority": {
      "type": "string",
      "enum": ["P0", "P1", "P2", "P3"]
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "due_at": {
      "type": "string"
    },
    "cron": {
      "type": "string"
    },
    "dry_run": {
      "type": "boolean"
    }
  },
  "required": ["id"],
  "additionalProperties": false
}

Output schema

Section titled “Output schema”
{
  "type": "object",
  "additionalProperties": true
}

sidekick-task:cancel

Section titled “sidekick-task:cancel”
  • Permission: admin
  • Required approvals: None
  • Required scopes: path read .sidekick/**, path write .sidekick/**

Input schema

Section titled “Input schema”
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1
    },
    "dry_run": {
      "type": "boolean"
    }
  },
  "required": ["id"],
  "additionalProperties": false
}

Output schema

Section titled “Output schema”
{
  "type": "object",
  "additionalProperties": true
}

sidekick-task:complete

Section titled “sidekick-task:complete”
  • Permission: write
  • Required approvals: None
  • Required scopes: path read .sidekick/**, path write .sidekick/**

Input schema

Section titled “Input schema”
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1
    },
    "note": {
      "type": "string"
    },
    "dry_run": {
      "type": "boolean"
    }
  },
  "required": ["id"],
  "additionalProperties": false
}

Output schema

Section titled “Output schema”
{
  "type": "object",
  "additionalProperties": true
}

sidekick-task:schedule

Section titled “sidekick-task:schedule”
  • Permission: write
  • Required approvals: None
  • Required scopes: path read .sidekick/**, path write .sidekick/**

Input schema

Section titled “Input schema”
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1
    },
    "due_at": {
      "type": "string"
    },
    "cron": {
      "type": "string"
    },
    "dry_run": {
      "type": "boolean"
    }
  },
  "required": ["id"],
  "additionalProperties": false
}

Output schema

Section titled “Output schema”
{
  "type": "object",
  "additionalProperties": true
}

memory:store

Section titled “memory:store”
  • Permission: write
  • Required approvals: None
  • Required scopes: path read .sidekick/**, path write .sidekick/**

Input schema

Section titled “Input schema”
{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": ["fact", "preference", "note", "snippet"]
    },
    "content": {
      "type": "string",
      "minLength": 1
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "dry_run": {
      "type": "boolean"
    }
  },
  "required": ["type", "content"],
  "additionalProperties": false
}

Output schema

Section titled “Output schema”
{
  "type": "object",
  "additionalProperties": true
}

memory:recall

Section titled “memory:recall”
  • Permission: read
  • Required approvals: None
  • Required scopes: path read .sidekick/**

Input schema

Section titled “Input schema”
{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "type": {
      "type": "string",
      "enum": ["fact", "preference", "note", "snippet"]
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "limit": {
      "type": "integer",
      "minimum": 1
    }
  },
  "additionalProperties": false
}

Output schema

Section titled “Output schema”
{
  "type": "object",
  "additionalProperties": true
}

memory:forget

Section titled “memory:forget”
  • Permission: admin
  • Required approvals: None
  • Required scopes: path read .sidekick/**, path write .sidekick/**

Input schema

Section titled “Input schema”
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1
    },
    "dry_run": {
      "type": "boolean"
    }
  },
  "required": ["id"],
  "additionalProperties": false
}

Output schema

Section titled “Output schema”
{
  "type": "object",
  "additionalProperties": true
}

memory:update

Section titled “memory:update”
  • Permission: write
  • Required approvals: None
  • Required scopes: path read .sidekick/**, path write .sidekick/**

Input schema

Section titled “Input schema”
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1
    },
    "type": {
      "type": "string",
      "enum": ["fact", "preference", "note", "snippet"]
    },
    "content": {
      "type": "string",
      "minLength": 1
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "dry_run": {
      "type": "boolean"
    }
  },
  "required": ["id"],
  "additionalProperties": false
}

Output schema

Section titled “Output schema”
{
  "type": "object",
  "additionalProperties": true
}

channel:configure

Section titled “channel:configure”
  • Permission: write
  • Required approvals: None
  • Required scopes: path read .sidekick/**, path write .sidekick/**

Input schema

Section titled “Input schema”
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1
    },
    "type": {
      "type": "string",
      "enum": ["terminal"]
    },
    "dry_run": {
      "type": "boolean"
    }
  },
  "required": ["name"],
  "additionalProperties": false
}

Output schema

Section titled “Output schema”
{
  "type": "object",
  "additionalProperties": true
}

channel:list

Section titled “channel:list”
  • Permission: read
  • Required approvals: None
  • Required scopes: path read .sidekick/**

Input schema

Section titled “Input schema”
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Output schema

Section titled “Output schema”
{
  "type": "object",
  "additionalProperties": true
}

channel:delete

Section titled “channel:delete”
  • Permission: admin
  • Required approvals: None
  • Required scopes: path read .sidekick/**, path write .sidekick/**

Input schema

Section titled “Input schema”
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1
    },
    "dry_run": {
      "type": "boolean"
    }
  },
  "required": ["id"],
  "additionalProperties": false
}

Output schema

Section titled “Output schema”
{
  "type": "object",
  "additionalProperties": true
}

channel:send

Section titled “channel:send”
  • Permission: write
  • Required approvals: None
  • Required scopes: path read .sidekick/**, path write .sidekick/**

Input schema

Section titled “Input schema”
{
  "type": "object",
  "properties": {
    "provider": {
      "type": "string"
    },
    "channel": {
      "type": "string"
    },
    "content": {
      "type": "string",
      "minLength": 1
    },
    "sender": {
      "type": "string"
    },
    "metadata": {
      "type": "object",
      "additionalProperties": true
    },
    "dry_run": {
      "type": "boolean"
    }
  },
  "required": ["content"],
  "additionalProperties": false
}

Output schema

Section titled “Output schema”
{
  "type": "object",
  "additionalProperties": true
}

channel:receive

Section titled “channel:receive”
  • Permission: read
  • Required approvals: None
  • Required scopes: path read .sidekick/**

Input schema

Section titled “Input schema”
{
  "type": "object",
  "properties": {
    "provider": {
      "type": "string"
    },
    "channel": {
      "type": "string"
    },
    "cursor": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "minimum": 1
    },
    "since": {
      "type": "string"
    },
    "metadata": {
      "type": "object",
      "additionalProperties": true
    }
  },
  "additionalProperties": false
}

Output schema

Section titled “Output schema”
{
  "type": "object",
  "additionalProperties": true
}

routine:create

Section titled “routine:create”
  • Permission: write
  • Required approvals: None
  • Required scopes: path read .sidekick/**, path write .sidekick/**

Input schema

Section titled “Input schema”
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1
    },
    "steps": {
      "type": "array",
      "minItems": 1,
      "items": {
        "type": "object",
        "properties": {
          "tool": {
            "type": "string",
            "minLength": 1
          },
          "input": {
            "type": "object",
            "additionalProperties": true
          }
        },
        "required": ["tool"],
        "additionalProperties": false
      }
    },
    "cron": {
      "type": "string"
    },
    "enabled": {
      "type": "boolean"
    },
    "dry_run": {
      "type": "boolean"
    }
  },
  "required": ["name", "steps"],
  "additionalProperties": false
}

Output schema

Section titled “Output schema”
{
  "type": "object",
  "additionalProperties": true
}

routine:list

Section titled “routine:list”
  • Permission: read
  • Required approvals: None
  • Required scopes: path read .sidekick/**

Input schema

Section titled “Input schema”
{
  "type": "object",
  "properties": {
    "enabled_only": {
      "type": "boolean"
    },
    "limit": {
      "type": "integer",
      "minimum": 1
    }
  },
  "additionalProperties": false
}

Output schema

Section titled “Output schema”
{
  "type": "object",
  "additionalProperties": true
}

routine:update

Section titled “routine:update”
  • Permission: write
  • Required approvals: None
  • Required scopes: path read .sidekick/**, path write .sidekick/**

Input schema

Section titled “Input schema”
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1
    },
    "name": {
      "type": "string",
      "minLength": 1
    },
    "steps": {
      "type": "array",
      "minItems": 1,
      "items": {
        "type": "object",
        "properties": {
          "tool": {
            "type": "string",
            "minLength": 1
          },
          "input": {
            "type": "object",
            "additionalProperties": true
          }
        },
        "required": ["tool"],
        "additionalProperties": false
      }
    },
    "cron": {
      "type": "string"
    },
    "enabled": {
      "type": "boolean"
    },
    "dry_run": {
      "type": "boolean"
    }
  },
  "required": ["id"],
  "additionalProperties": false
}

Output schema

Section titled “Output schema”
{
  "type": "object",
  "additionalProperties": true
}

routine:delete

Section titled “routine:delete”
  • Permission: admin
  • Required approvals: None
  • Required scopes: path read .sidekick/**, path write .sidekick/**

Input schema

Section titled “Input schema”
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1
    },
    "dry_run": {
      "type": "boolean"
    }
  },
  "required": ["id"],
  "additionalProperties": false
}

Output schema

Section titled “Output schema”
{
  "type": "object",
  "additionalProperties": true
}

routine:run

Section titled “routine:run”
  • Permission: read
  • Required approvals: None
  • Required scopes: path read .sidekick/**

Input schema

Section titled “Input schema”
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1
    }
  },
  "required": ["id"],
  "additionalProperties": false
}

Output schema

Section titled “Output schema”
{
  "type": "object",
  "additionalProperties": true
}

sidekick:routine:commit_plan

Section titled “sidekick:routine:commit_plan”
  • Permission: write
  • Required approvals: None
  • Required scopes: path read .sidekick/**, path write .sidekick/**

Input schema

Section titled “Input schema”
{
  "type": "object",
  "properties": {
    "plan_id": {
      "type": "string",
      "minLength": 1
    },
    "attestation": {
      "type": "object",
      "properties": {
        "actor": {
          "type": "string",
          "minLength": 1
        },
        "reason": {
          "type": "string",
          "minLength": 1
        }
      },
      "required": ["actor", "reason"],
      "additionalProperties": true
    }
  },
  "required": ["plan_id", "attestation"],
  "additionalProperties": false
}

Output schema

Section titled “Output schema”
{
  "type": "object",
  "additionalProperties": true
}

sidekick:init

Section titled “sidekick:init”
  • Permission: write
  • Required approvals: None
  • Required scopes: path read .sidekick/**, path write .sidekick/**

Input schema

Section titled “Input schema”
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Output schema

Section titled “Output schema”
{
  "type": "object",
  "additionalProperties": true
}

sidekick:status

Section titled “sidekick:status”
  • Permission: read
  • Required approvals: None
  • Required scopes: path read .sidekick/**

Input schema

Section titled “Input schema”
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Output schema

Section titled “Output schema”
{
  "type": "object",
  "additionalProperties": true
}

sidekick:export

Section titled “sidekick:export”
  • Permission: read
  • Required approvals: None
  • Required scopes: path read .sidekick/**

Input schema

Section titled “Input schema”
{
  "type": "object",
  "properties": {
    "include_audit": {
      "type": "boolean"
    }
  },
  "additionalProperties": false
}

Output schema

Section titled “Output schema”
{
  "type": "object",
  "additionalProperties": true
}