Importing your context

An empty store is not much of a demonstration. This product becomes obvious only once it can answer something you never told it, which needs context it does not have on day one.

So npx hivemind-cli init offers to import what you have already written for your agents.

What it reads

The context files you wrote yourself, in your repositories and your home directory:

Nested ones too, not only the file at the root, a monorepo's per-package AGENTS.md is usually the most specific context in the repository.

These need no processing. They were written to be read by an agent, so they are already in the shape a memory wants: the importer splits them on their own headings and stores the sections.

What it does not read

Your chat history. No transcripts, from any tool.

Nothing goes to a model to be summarised. There is no extraction step, no inference, and nothing leaves your machine except the text of files you wrote.

You see it before it is sent

The importer prints every file it found, its size, and how many memories it would become, then waits:

  hivemind, 8 memories
      CLAUDE.md                        8 × 3 KB   claude-code
  acme-api, 45 memories
      AGENTS.md                       45 × 26 KB  agents-md
      packages/api/AGENTS.md           4 × 2 KB   agents-md

  Upload 57 memories from 2 origins to your Hivemind account? [y/N]

Nothing is sent before you answer. To look without any possibility of sending:

npx hivemind-cli import --dry-run

A non-interactive run, piped, or in CI, sends nothing at all unless you pass --yes.

Where things land

One repository becomes one origin, named after its directory. Files in your home directory land in default, because they apply everywhere rather than to one project.

Running it again is safe

Memories are keyed by the file and heading they came from, so a second run updates what changed rather than storing a second copy. Edit an AGENTS.md, run it again, and the memory changes with it.

npx hivemind-cli import

Searching somewhere else

By default it looks in your repositories under the usual places. To point it somewhere else:

npx hivemind-cli import --scan ~/work/clients

To configure your tools without importing anything:

npx hivemind-cli init --no-import

Removing what it added

Everything it stored is an ordinary memory. Delete one from Memories in the dashboard, or describe a set in Bulk forget, which shows everything that matches before anything is deleted.