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

# Tools Reference

All 17 tools for container execution, file management, and operations.

<Columns cols={2}>
  <Card title="run" href="./run" icon="play" />

  <Card title="rsync" href="./rsync" icon="arrows-rotate" />

  <Card title="import_image" href="./import_image" icon="file-import" />

  <Card title="registry_token_obtain" href="./registry_token_obtain" icon="ticket" />

  <Card title="registry_auth" href="./registry_auth" icon="key" />

  <Card title="list_images" href="./list_images" icon="images" />

  <Card title="get_image" href="./get_image" icon="image" />

  <Card title="set_tag" href="./set_tag" icon="tag" />

  <Card title="upload" href="./upload" icon="upload" />

  <Card title="download" href="./download" icon="download" />

  <Card title="list_files" href="./list_files" icon="folder-open" />

  <Card title="read_file" href="./read_file" icon="file-lines" />

  <Card title="get_operation" href="./get_operation" icon="magnifying-glass" />

  <Card title="list_operations" href="./list_operations" icon="list-check" />

  <Card title="wait_operations" href="./wait_operations" icon="hourglass-half" />

  <Card title="cancel_operation" href="./cancel_operation" icon="ban" />

  <Card title="get_guide" href="./get_guide" icon="circle-question" />
</Columns>

## Quick Reference

### Command Execution

| Tool         | Description                  | Cost           |
| ------------ | ---------------------------- | -------------- |
| [run](./run) | Execute command in container | Spawns microVM |

### File Transfer

| Tool                   | Description                   | Cost  |
| ---------------------- | ----------------------------- | ----- |
| [rsync](./rsync)       | Sync local files with caching | No VM |
| [upload](./upload)     | Upload single file            | No VM |
| [download](./download) | Download file from image      | No VM |

### Image Management

| Tool                                               | Description                    | Cost           |
| -------------------------------------------------- | ------------------------------ | -------------- |
| [import\_image](./import_image)                    | Import from registry           | Spawns microVM |
| [registry\_token\_obtain](./registry_token_obtain) | Open browser for PAT creation  | No VM          |
| [registry\_auth](./registry_auth)                  | Validate and store credentials | No VM          |
| [list\_images](./list_images)                      | List available images          | No VM          |
| [get\_image](./get_image)                          | Get image by UUID/tag          | No VM          |
| [set\_tag](./set_tag)                              | Set or remove tag              | No VM          |

### Image Inspection

| Tool                        | Description          | Cost  |
| --------------------------- | -------------------- | ----- |
| [list\_files](./list_files) | List files in image  | No VM |
| [read\_file](./read_file)   | Read file from image | No VM |

### Operations

| Tool                                    | Description           | Cost  |
| --------------------------------------- | --------------------- | ----- |
| [get\_operation](./get_operation)       | Get operation status  | No VM |
| [list\_operations](./list_operations)   | List operations       | No VM |
| [wait\_operations](./wait_operations)   | Wait for multiple ops | No VM |
| [cancel\_operation](./cancel_operation) | Cancel operation      | No VM |

### Documentation

| Tool                      | Description        | Cost  |
| ------------------------- | ------------------ | ----- |
| [get\_guide](./get_guide) | Get guide sections | No VM |

## Common Patterns

### Basic Execution

```json theme={null}
{"tool": "run", "args": {"command": "python -c 'print(1)'", "image": "img-uuid"}}
```

### With Local Files

```json theme={null}
{"tool": "rsync", "args": {"source": "/project", "destination": "/app"}}
{"tool": "run", "args": {"command": "python /app/main.py", "image": "img-uuid", "directory_state_id": "ds-uuid"}}
```

### Parallel Execution

```json theme={null}
{"tool": "run", "args": {"command": "test1.py", "image": "img", "wait": false}}
{"tool": "run", "args": {"command": "test2.py", "image": "img", "wait": false}}
{"tool": "wait_operations", "args": {"operation_ids": ["op-1", "op-2"]}}
```

### Inspect Container (No VM)

```json theme={null}
{"tool": "list_files", "args": {"image": "img-uuid", "path": "/etc"}}
{"tool": "read_file", "args": {"image": "img-uuid", "path": "/etc/os-release"}}
```