elnora-ai/elnora-files

Elnora Files

Browse, read, create, upload, version, and manage files on the Elnora AI Platform.

Tool Access

Elnora is available via two methods. Use whichever is configured.

Option A — CLI via Bash (preferred)

Run commands via your Bash/Shell tool as elnora <group> <action> .... Verify with elnora --version. CLI uses ~5× fewer tokens than MCP.

Option B — MCP tools (when CLI isn't installed)

Look for tools prefixed mcp__elnora__ in your available tools. Call them with structured parameters (camelCase — e.g. projectId, not project-id). See the "MCP Tool Names" table below for the mapping.

If neither is available, tell the user to install one:

• CLI: curl -fsSL https://cli.elnora.ai/install.sh | bash (macOS/Linux) or irm https://cli.elnora.ai/install.ps1 | iex (Windows)
• MCP: claude mcp add elnora --transport http --scope user https://mcp.elnora.ai/mcp then /mcp to authenticate.

Never fabricate tool names. Valid commands are in the Commands section; their MCP equivalents are in the MCP Tool Names table.

Invocation

CLI="elnora"

Commands

List Files

$CLI --compact files list --project <PROJECT_ID>
$CLI --compact files list --project <PROJECT_ID> --page 2 --page-size 50
$CLI --compact --fields "id,name" files list --project <PROJECT_ID>

--project is required.

Get File Metadata

$CLI --compact files get <FILE_ID>

Returns metadata (name, type, size, timestamps) without actual content.

Get File Content

$CLI files content <FILE_ID>

Returns raw file content to stdout. Pipe to save:

$CLI files content <FILE_ID> > protocol.md

Note: --compact or --fields wraps output in JSON. Omit both for raw text.

Download File

$CLI files download <FILE_ID>

Downloads file content via the /download endpoint (may differ from content in backend handling).

Get Version History

$CLI --compact files versions <FILE_ID>
$CLI --compact files versions <FILE_ID> --page-size 10

Get Version Content

$CLI files version-content <FILE_ID> <VERSION_ID>

Both <FILE_ID> and <VERSION_ID> are positional. Returns raw content.

Create Version

$CLI --compact files create-version <FILE_ID>
$CLI --compact files create-version <FILE_ID> --content "Updated protocol text"

Restore Version

$CLI --compact files restore <FILE_ID> <VERSION_ID>

Both positional. Destructive — confirm with user first.

Create File

$CLI --compact files create --project <PROJECT_ID> --name "protocol.md" --type Document
$CLI --compact files create --project <PROJECT_ID> --name "data.csv" --type Dataset --folder <FOLDER_ID>

| Flag | Required | Notes | |------|----------|-------| | --project | Yes | Project UUID | | --name | Yes | File name | | --type | Yes | File type (e.g. Document, Protocol, Dataset) | | --folder | No | Folder UUID |

Upload File

$CLI --compact files upload --project <PROJECT_ID> --file-path /path/to/file.md
$CLI --compact files upload --project <PROJECT_ID> --file-path /path/to/data.csv --file-name "renamed.csv" --content-type "text/csv"

Three-step process (handled automatically): presigned URL, upload, confirm.

| Flag | Required | Notes | |------|----------|-------| | --project | Yes | Project UUID | | --file-path | Yes | Local file path | | --file-name | No | Override filename | | --content-type | No | MIME type (defaults to application/octet-stream) |

Upload Batch

$CLI --compact files upload-batch --project <PROJECT_ID> --file-paths "a.pdf,b.docx,c.txt"
$CLI --compact files upload-batch --project <PROJECT_ID> --file-paths "file1.md,file2.md" --folder <FOLDER_ID>

Uploads up to 50 files. Returns per-file success/failure results.

| Flag | Required | Notes | |------|----------|-------| | --project | Yes | Project UUID | | --file-paths | Yes | Comma-separated local file paths | | --folder | No | Folder UUID (applies to all files) |

Confirm Upload

$CLI --compact files confirm-upload <FILE_ID>

Only needed if upload was interrupted after the PUT step.

Update File

$CLI --compact files update <FILE_ID> --name "new-name.md"
$CLI --compact files update <FILE_ID> --folder <FOLDER_ID>

Must provide at least one of --name or --folder.

Archive File

$CLI --compact files archive <FILE_ID>
# -> {"archived":true,"fileId":"<UUID>"}

Destructive — confirm with user before running.

Promote File

$CLI --compact files promote <FILE_ID> --visibility <LEVEL>

--visibility is required.

Fork File

$CLI --compact files fork <FILE_ID> --target-project <PROJECT_ID>

<FILE_ID> is positional (fileId). --target-project is a flag (targetProject doesn't end in "Id").

Working Copy

$CLI --compact files working-copy <FILE_ID>
$CLI --compact files working-copy <FILE_ID> --task <TASK_ID>

Commit Working Copy

$CLI --compact files commit <FILE_ID>

Search File Content

$CLI --compact files search-content --query "annealing temperature"
$CLI --compact files search-content --query "BRCA1" --project <PROJECT_ID>
$CLI --compact files search-content --query "gel electrophoresis" --page-size 10

Full-text search inside file contents. Also available as search file-content.

| Flag | Required | Notes | |------|----------|-------| | --query | Yes | Search query string (no -q shorthand) | | --project | No | Project UUID to filter | | --page | No | Page number (default 1) | | --page-size | No | Results per page (default 25, max 100) |

MCP Tool Names

| CLI command | MCP tool name | |-------------|---------------| | files list | elnora_files_list | | files get | elnora_files_get | | files content | elnora_files_content | | files download | elnora_files_download | | files versions | elnora_files_versions | | files version-content | elnora_files_versionContent | | files create-version | elnora_files_createVersion | | files restore | elnora_files_restore | | files create | elnora_files_create | | files upload | elnora_files_upload | | files upload-batch | elnora_files_uploadBatch | | files confirm-upload | elnora_files_confirmUpload | | files update | elnora_files_update | | files archive | elnora_files_archive | | files promote | elnora_files_promote | | files fork | elnora_files_fork | | files working-copy | elnora_files_workingCopy | | files commit | elnora_files_commit | | files search-content | elnora_files_searchContent |

Agent Recipes

Read a protocol from a project:

$CLI --compact --fields "id,name" files list --project <PROJECT_ID>
$CLI files content <FILE_ID>

Upload a file and reference it in a task:

$CLI --compact files upload --project <PROJECT_ID> --file-path /path/to/protocol.md
# Use the returned file ID:
$CLI --compact tasks send <TASK_ID> --message "Optimize this protocol" --file-refs "<FILE_ID>" --wait

Edit-in-place (working copy):

WC=$($CLI --compact files working-copy <FILE_ID> | jq -r '.id')
# ... make edits externally ...
$CLI --compact files commit "$WC"