---
name: Hivemind Goals
slug: hivemind-goals-3
category: Automation
description: Hivemind Goals creates, tracks, and updates team goals and KPIs using the hivemind CLI. Use it when someone mentions a goal, objective, KPI, task, or wants to capture and resume actionable work items with full context.
github: "https://github.com/activeloopai/hivemind/tree/main/harnesses/hermes/skills/hivemind-goals"
language: TypeScript
stars: 1561
forks: 101
install: "npx degit https://github.com/activeloopai/hivemind/tree/main/harnesses/hermes/skills/hivemind-goals ~/.claude/skills/hivemind-goals"
installs_to: ~/.claude/skills/hivemind-goals
source_path: harnesses/hermes/skills/hivemind-goals/SKILL.md
collection_size: 10
category_size: 1523
collection_url: "https://dirskills.com/collections/activeloopai/hivemind"
added: 2026-08-19T07:26:29.108Z
last_synced: 2026-08-19T07:26:29.108Z
canonical_url: "https://dirskills.com/skills/hivemind-goals-3"
---

# Hivemind Goals

Hivemind Goals creates, tracks, and updates team goals and KPIs using the hivemind CLI. Use it when someone mentions a goal, objective, KPI, task, or wants to capture and resume actionable work items with full context.

**Install:**

```bash
npx degit https://github.com/activeloopai/hivemind/tree/main/harnesses/hermes/skills/hivemind-goals ~/.claude/skills/hivemind-goals
```

## README

# Hivemind Goals — CLI only (Hermes)

⚠️  **CRITICAL: On this runtime (Hermes), you MUST use the `hivemind` shell CLI for goals + KPIs. DO NOT use `write_file` on `~/.deeplake/memory/goal/...` paths — those writes go to the local filesystem and never reach the team-shared `hivemind_goals` table. Other team members will NOT see them.**

The hivemind-memory skill describes a generic memory layout — it does NOT apply to goals/KPIs. For goals/KPIs, use the CLI below.

## Commands (invoke via terminal tool)

```
hivemind goal add "<text>"                                  # create goal, prints goal_id
hivemind goal list [--mine|--all]                           # list (default --mine)
hivemind goal done <goal_id>                                # mark closed
hivemind goal progress <goal_id> <opened|in_progress|closed>

hivemind kpi add <goal_id> <kpi_id> <target> <unit> [name]  # add KPI to goal
hivemind kpi list <goal_id>                                 # list KPIs for goal
hivemind kpi bump <goal_id> <kpi_id> <delta>                # increment current (int)
```

## Workflow when the user expresses a goal

1. `hivemind goal add "<short description>"` — capture stdout, that's the `goal_id` (UUID).
2. If the user explicitly asks for KPIs: `hivemind kpi add <goal_id> <slug> <target> <unit>` per KPI.
3. Tell the user the goal_id and that it is now team-visible in Deeplake.

## Capture a task for later (with resumable context)

When the user **parks a tangential task** mid-session — "save this for later", "remind me to …", "don't let me forget …", "let's do X later" — store enough **context to resume cold** later, not just a one-liner. Tag it `--agent capture` so parked side-tasks are separable from hand-made goals:

```
hivemind goal add --agent capture "Add rate-limiting to the webhook handler

Start here: add a per-IP token bucket on the handler entry path
Files: src/webhook/handler.ts:120-160, src/webhook/limits.ts
Branch: feat/webhook-hardening
Run: pnpm test webhook
Why: bursty clients hammer the endpoint; defer until retry-backoff lands"
```

Line 1 is the label (what `goal list` shows). Fill `Start here / Files / Branch / Run / Why` from the conversation; `Start here:` matters most. Pass the whole package as **one double-quoted argument** so the newlines are preserved.

## Resume a parked task (automatic context transfer)

When the user says "let's work on that task / goal" or "pick up the `<X>` task":

1. `hivemind goal list --mine` — match the user's reference to a `goal_id`.
2. `hivemind goal get <goal_id>` — prints the **full** package (`goal list` shows only the first line, so always use `goal get`). Read it as your working context.
3. `hivemind goal progress <goal_id> in_progress` — mark it started.
4. Begin from `Start here:` using the `Files` / `Branch` / `Run` lines. Continue as if the context was never lost.

## What NOT to do

- Do NOT call `write_file` on any path under `~/.deeplake/memory/goal/` or `~/.deeplake/memory/kpi/`.
- Do NOT do `mkdir` / `cat >` to create those files manually via terminal.
- Do NOT auto-generate KPIs unless the user explicitly asks.

If the user wants to inspect goals you created, run `hivemind goal list --mine` (terminal) and present the output.