| 💾 Saved. d722711 k33g 9h ago | 1 | # Point the model at a file with `@path` |
| 2 | |
| 3 | Name a file or a directory in your question with `@` followed by its path. mini-me checks that the path exists, tells the model where it is, and the model reads it with its tools. There is no picker or completion: you type the path. |
| 4 | |
| 5 | ## Steps |
| 6 | |
| 7 | 1. Start `mm` from the project directory. Relative paths are resolved from there. |
| 8 | 2. Write the path in the question, glued to `@`: |
| 9 | |
| 10 | ``` |
| 11 | > explain what @internal/acp/acp.go does with @internal/session |
| 12 | 📎 /work/mini-me/internal/acp/acp.go |
| 13 | 📎 /work/mini-me/internal/session |
| 14 | ``` |
| 15 | |
| 16 | One `📎` line per attached path confirms the notation was understood. The model receives your sentence as typed, followed by one line per path: |
| 17 | |
| 18 | ``` |
| 19 | [attached file: /work/mini-me/internal/acp/acp.go] |
| 20 | [attached directory: /work/mini-me/internal/session] |
| 21 | ``` |
| 22 | |
| 23 | 3. Ask away. The content is not copied into the prompt: the model runs `cat`, `read_file` or `ls` on the path when it needs to. |
| 24 | |
| 25 | ## Rules |
| 26 | |
| 27 | | Case | Result | |
| 28 | |------|--------| |
| 29 | | `@internal/acp/acp.go` | Relative to the directory `mm` was started in (the session's `cwd` in ACP mode). | |
| 30 | | `@/abs/path`, `@~/file` | Absolute paths and `~` work. | |
| 31 | | `@main.go,` `(@main.go)` `"@main.go"` | Sentence punctuation and brackets around the mention are ignored. | |
| 32 | | `@bob`, `@does/not/exist` | Nothing on disk: left in the sentence as plain text, no attachment. | |
| 33 | | `k33g@example.com` | A `@` glued to a word is not a mention. | |
| 34 | | Same path twice | Attached once. | |
| 35 | | Path with spaces | Not supported: a mention ends at the first space. | |
| 36 | |
| 37 | ## In an editor (ACP) |
| 38 | |
| 39 | The editor's own `@` picker sends the file as a `resource_link`, which mini-me turns into the same `[attached file: …]` line. A path typed by hand, without the picker, is understood the same way, relative to the project the editor opened. Attached paths are logged on stderr as `[acp] session <id>: attached <path>`. |
| 40 | |
| 41 | ## See also |
| 42 | |
| 43 | - [Built-in tools](../reference/tools.md) — what the model reads the file with |
| 44 | - [Use mini-me from an editor](use-from-an-editor.md) |