# Hivemind Goals

Create, track and update team goals via the Deeplake virtual filesystem at memory/goal/.

- 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 via the Deeplake virtual filesystem at memory/goal/. 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

Track goals as Markdown files inside the Deeplake virtual filesystem. Each file is one row in a dedicated team-shared table, the path encodes the structural metadata, the file body holds the human-readable description.

## When to use this skill

Activate when the user expresses any of:
- "I want to track X / aim for X / track my progress on Y"
- "add a goal", "what are my goals?"
- "mark this as done", "close that goal"
- "shipping X by Friday", "5 PRs this week", any measurable target
- "create a task", "add a todo", "remind me to fix X", any work item (the goals system absorbs the old `hivemind tasks` CLI, there is no separate task store)

For "list my goals" → run `ls ~/.deeplake/memory/goal/<userName>/opened/` and `ls ~/.deeplake/memory/goal/<userName>/in_progress/`. If empty, ask the user if they want to create one.

## Path conventions (LEARN THESE)

```
~/.deeplake/memory/goal/<owner>/<status>/<goal_id>.md
```

- `<owner>`, user identifier (use the userName from `hivemind whoami` or the credentials)
- `<status>`, one of `opened`, `in_progress`, `closed`
- `<goal_id>`, UUIDv4 you generate at create time

**Path encoding is the source of truth.** The owner, status, and goal_id come from the path, NOT from the file body. Do NOT write owner/status/goal_id inside the file content.

## File body format

Goal file body, plain markdown, free form:
```
ship the goals-graph feature

Notes: route every write through the VFS, no separate CLI.
Due: 2026-05-30.
```

The first line is the human-readable label (what `goal list` and the SessionStart banner show). Anything else is free notes.

## Operations

### 1. Create a new goal

When the user expresses a new goal:

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