> ## Documentation Index
> Fetch the complete documentation index at: https://docs.linksee.app/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI Commands

> Command-line utilities included with linksee-memory

The `linksee-memory` npm package includes several CLI utilities beyond the MCP server itself.

<Info>
  Each CLI is reachable two ways: as a subcommand via `npx -y linksee-memory <sub>` (no install needed — the package name resolves on a cold machine), and, if `linksee-memory` is installed on your PATH, as the standalone `linksee-memory-<sub>` bin (e.g. `linksee-memory-setup`). The runnable examples below use the cold-safe `npx -y linksee-memory <sub>` form.
</Info>

## linksee-memory

The main MCP server. Runs in **stdio mode** — typically launched by your MCP client, not directly.

```bash theme={null}
npx -y linksee-memory
```

## linksee-memory setup

Interactive initial setup. Creates the database directory and initializes the schema.

```bash theme={null}
npx -y linksee-memory setup
```

## linksee-memory install-skill

Install the Linksee Memory skill into Claude Code's MCP configuration.

```bash theme={null}
npx -y linksee-memory install-skill
```

## linksee-memory stats

Display database statistics: entity count, memory count, layer breakdown, heat distribution, database size.

```bash theme={null}
npx -y linksee-memory stats
```

Example output:

```
Linksee Memory Stats
====================
Entities:     24
Memories:     186
  goal:       12
  context:    34
  emotion:    8
  implementation: 78
  caveat:     22
  learning:   32
Heat bands:
  hot:        15
  warm:       42
  cold:       89
  frozen:     40
File snapshots: 67
DB size:      4.2 MB
```

## linksee-memory import

Import session transcripts or external data into the memory store.

```bash theme={null}
npx -y linksee-memory import <file>
```

## linksee-memory sync

Sync a session's data. Useful for manual synchronization after disconnects.

```bash theme={null}
npx -y linksee-memory sync <session-id>
```
