# Hivemind Goals

Create, track and update team goals in Hivemind via the `hivemind` CLI.

- Repository: https://github.com/activeloopai/hivemind (1640 stars)
- Category: Engineering
- License: Apache-2.0
- Last updated: 2026-10-24
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add activeloopai/hivemind --skill hivemind-goals -g -a claude-code -y`
Codex: `npx skills add activeloopai/hivemind --skill hivemind-goals -g -a codex -y`
Cursor: `npx skills add activeloopai/hivemind --skill hivemind-goals -g -a cursor -y`
Gemini CLI: `npx skills add activeloopai/hivemind --skill hivemind-goals -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add activeloopai/hivemind`

## Description

Create, track and update team goals in Hivemind via the `hivemind` CLI. Use whenever the user mentions a goal, objective, target, milestone, or asks to track progress on something measurable. ALSO use when the user says "task", "todo", "work item", "remind me to", "fix X", or any actionable work item, the goal system replaced the legacy `hivemind tasks` CLI and now covers both objectives and tasks.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Hivemind Goals, CLI only (Hermes)

⚠️  **CRITICAL: On this runtime (Hermes), you MUST use the `hivemind` shell CLI for goals. 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. For goals, 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>
```

## Workflow when the user expresses a goal

1. `hivemind goal add "<short description>"`, capture stdout, that's the `goal_id` (UUID).
2. 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)

The rest: https://github.com/activeloopai/hivemind/blob/HEAD/harnesses/hermes/skills/hivemind-goals/SKILL.md