---
name: nessie
description: Access the user's personal context from Nessie — their profile, saved contexts, and folders. Use when the user references prior work, asks "what do I know about X", or needs personalized responses based on their background.
---

# Nessie — Personal Context Engine

Nessie gives you access to the user's personal context — their profile,
saved contexts, and folders. Nessie builds context by analyzing the user's
AI conversation history across ChatGPT, Claude, Gemini, and Perplexity.

## Prerequisites

The Nessie macOS app must be running. Check with:
  nessie status

## Commands

### Profile (instant, no cost)
  nessie profile
Returns the user's structured profile: name, biography, expertise, work history,
communication preferences, personality traits, and known connections. Use this to
personalize your responses and understand who you're working with.

### Search (instant, no cost)
  nessie search "<query>"
  nessie search "<query>" --semantic
  nessie search "<query>" --limit 20
Search across all contexts. Uses full-text search by default. Add `--semantic`
for vector-based semantic search. Default limit is 10, max 50.

### Contexts (instant, no cost)
  nessie context list
  nessie context get <id>
  nessie context move <id> --to <folder-id>
  nessie context move <id> --unfiled
  nessie context rename <id> --name "<new name>"
  nessie context delete <id>
Contexts are the user's saved context documents. Use `list` to browse all
contexts with their folder membership, `get` to retrieve full content by UUID.

### Folders (instant, no cost)
  nessie folder list
  nessie folder get <id>
  nessie folder create --name "<name>"
  nessie folder rename <id> --name "<new name>"
  nessie folder delete <id>
Folders organize contexts. Use `get` to see a folder's contexts and child folders.
`delete` only works on empty folders — move or delete contents first.

## When to Use

1. **Start of session**: Run `nessie profile` to understand the user.
2. **User references prior work or context**: Run `nessie search` with relevant
   terms. If results are found, `nessie context get` the best match.
3. **User asks "what do I know about X"**: Search contexts, then retrieve the
   most relevant ones.
4. **Organizing contexts**: Use `context move`, `context rename`, `context delete`,
   `folder create`, `folder rename`, and `folder delete` to help the user organize
   their context library.

## Important

- All commands are instant local reads/writes — use freely.
- All data is local to the user's machine. Nessie never sends documents to external services.
