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

# mobster memory

> See and edit what Mobster remembers.

List, add and delete the things Mobster remembers, in your words. Mobster's agent reads the ones that fit each task. Everything stays on this Mac.

## Usage

```text theme={"theme":"css-variables"}
mobster memory [<command>]
```

```text theme={"theme":"css-variables"}
examples:
  mobster memory list
  mobster memory add "My gym is the one on 5th Street"
  mobster memory pin 3f9c2a1b7d0e
```

## Commands

| Command | What it does |
| - | - |
| [`mobster memory list`](#mobster-memory-list) | list what Mobster remembers (the default) |
| [`mobster memory add`](#mobster-memory-add) | tell Mobster something to remember |
| [`mobster memory rm`](#mobster-memory-rm) | forget one thing |
| [`mobster memory keep`](#mobster-memory-keep) | keep something Mobster learned |
| [`mobster memory pin`](#mobster-memory-pin) | send one thing with every eligible task in its scope |
| [`mobster memory unpin`](#mobster-memory-unpin) | send one thing only with eligible tasks that fit |
| [`mobster memory clear`](#mobster-memory-clear) | delete everything Mobster remembers |
| [`mobster memory export`](#mobster-memory-export) | print everything Mobster remembers as Markdown |

## `mobster memory list`

List what Mobster remembers: pinned things first, then the newest.

### Options

| Name | Default | Description |
| - | - | - |
| `--app BUNDLE` | none | only what Mobster remembers for this app (its bundle ID) |
| `--scope SCOPE` | none | only this scope: global, app:\<bundle>, project:\<id>, profile:\<id>, workflow:\<id>, profile:\<id>/workflow:\<id> or phone:\<id> |
| `--kind KIND` | none | only this kind (path, place, value, preference, rule, structure, device, outcome, cost or repo) |
| `--new` | off | only what Mobster learned since you last looked |
| `--json` | off | print JSON |

## `mobster memory add`

Tell Mobster something to remember, in your words (up to 300 characters). Pinned things go with eligible tasks in their scope; the rest go with tasks that fit. Mobster never remembers passwords, codes or card numbers.

### Arguments and options

| Name | Default | Description |
| - | - | - |
| `TEXT` | required | what to remember |
| `--app BUNDLE` | none | only for tasks in this app (its bundle ID) |
| `--scope SCOPE` | everywhere | where it applies: app:\<bundle>, project:\<id>, profile:\<id>, workflow:\<id>, profile:\<id>/workflow:\<id> or phone:\<id> |
| `--kind KIND` | value, or preference when pinned | what it is |
| `--pin` | off | send it with every eligible task in its scope (up to 10 pinned) |
| `--json` | off | print JSON |

```text theme={"theme":"css-variables"}
examples:
  mobster memory add "My gym is the one on 5th Street"
  mobster memory add "Sign my texts with – Sam" --app com.apple.MobileSMS --pin
```

## `mobster memory rm`

Forget one thing, by the ID `list` shows. Mobster won't learn it again for 90 days.

### Arguments

| Name | Default | Description |
| - | - | - |
| `ID` | required | the 12-character ID from `mobster memory list` |

## `mobster memory keep`

Keep one thing Mobster learned: it stops showing as new and is never offered for removal.

### Arguments

| Name | Default | Description |
| - | - | - |
| `ID` | required | the 12-character ID from `mobster memory list` |

## `mobster memory pin`

Pin one thing for every eligible task in its scope (up to 10 pinned).

### Arguments

| Name | Default | Description |
| - | - | - |
| `ID` | required | the 12-character ID from `mobster memory list` |

## `mobster memory unpin`

Unpin one thing: it goes only with eligible tasks that fit.

### Arguments

| Name | Default | Description |
| - | - | - |
| `ID` | required | the 12-character ID from `mobster memory list` |

## `mobster memory clear`

Delete everything Mobster remembers, and its suggestions. Asks you to type "delete everything" first, unless you add `--yes`.

### Options

| Name | Default | Description |
| - | - | - |
| `--yes` | off | don't ask |

## `mobster memory export`

Print everything Mobster remembers as Markdown, or save it with `--output`.

### Options

| Name | Default | Description |
| - | - | - |
| `--output FILE` | none | save it to this file instead |
| `--json` | off | export JSON with every fact's kind, source and scope |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.