Quick start
# Create a collection with initial documents
okra collections create "Q4 Earnings" -d "Quarterly filings" --docs ocr-abc123,ocr-def456
# List all collections
okra collections list
# Show collection details
okra collections show "Q4 Earnings"
# Add more documents
okra collections add "Q4 Earnings" ocr-ghi789
# Chat with a collection
okra chat -c "Q4 Earnings" -m "What was total revenue?"
Commands
okra collections list # list all collections
okra collections create "Name" # create empty collection
okra collections create "Name" -d "desc" # with description
okra collections create "Name" --docs id1,id2 # with initial documents
okra collections show <name-or-id> # show collection + documents
okra collections add <name-or-id> id1 id2 # add documents
okra collections remove <name-or-id> id1 id2 # remove documents
okra collections delete <name-or-id> # delete collection (keeps docs)
The collections command has a short alias: col. Use okra col ls instead of okra collections list.
collections list flags
| Flag | Description |
|---|
-o, --output <format> | Output format: table (default), json |
collections create flags
| Flag | Description |
|---|
-d, --description <text> | Optional description for the collection |
--docs <ids> | Comma-separated job IDs to add on creation |
collections show flags
| Flag | Description |
|---|
-o, --output <format> | Output format: table (default), json |
Chat with a collection
Use the -c flag on okra chat to scope a chat session to a collection:
# By collection name
okra chat -c "Q4 Earnings" -m "Compare revenue across companies"
# By collection ID
okra chat -c col-abc123def456 -m "Summarize key findings"
# Inline collection (comma-separated job IDs)
okra chat -c "ocr-abc123,ocr-def456" -m "What tables are in these docs?"
Phase 1: Collection chat currently uses the first document in the collection. Multi-document chat is coming soon.
Lookup behavior
All commands accept either a collection name or collection ID. The CLI tries ID lookup first, then falls back to name.
okra collections show "Q4 Earnings" # by name
okra collections show col-abc123def456 # by ID
