@koda-sl/baker-cli 0.3.0 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +52 -62
  2. package/dist/cli.js +1 -1
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -56,42 +56,35 @@ baker status
56
56
  # { "ok": true, "data": { "authenticated": true, "apiUrl": "https://..." } }
57
57
  ```
58
58
 
59
- ### `baker images list`
59
+ ### `baker images search <query>`
60
60
 
61
- List images with optional filters.
61
+ Semantic search using hybrid BM25 + vector + reranking. Only returns ready images.
62
62
 
63
63
  ```bash
64
- # List all ready images
65
- baker images list --status ready
66
-
67
- # Filter by tags and limit results
68
- baker images list --tags logo,illustration --limit 10
69
-
70
- # Compact tab-separated output
71
- baker images list --output files
64
+ # Basic search
65
+ baker images search "hero banner"
72
66
 
73
- # Only return specific fields
74
- baker images list --fields _id,name,status
67
+ # Filter by aspect ratio and tags
68
+ baker images search "logo" --aspect-ratio 1:1 --tags logo
75
69
 
76
- # Include full metadata (dimensions, colors, etc.)
77
- baker images list --full
70
+ # Limit results and set minimum relevance
71
+ baker images search "team photo" --limit 5 --min-score 0.3
78
72
 
79
- # Paginate through results
80
- baker images list --limit 20 --cursor <cursor_from_previous_response>
73
+ # Full metadata with markdown output
74
+ baker images search "product shot" --full --output md
81
75
  ```
82
76
 
83
77
  **Flags:**
84
78
 
85
- | Flag | Description |
86
- |------------|----------------------------------------------------|
87
- | `--status` | Filter: `ready`, `processing`, `uploading`, `error`|
88
- | `--tags` | Comma-separated tag names |
89
- | `--source` | Filter by source |
90
- | `--limit` | Max results (default 50) |
91
- | `--cursor` | Pagination cursor from previous response |
92
- | `--output` | Output format: `json` \| `files` \| `md` |
93
- | `--fields` | Comma-separated field names to include |
94
- | `--full` | Include full metadata |
79
+ | Flag | Description |
80
+ |------------------|--------------------------------------------------------------------------|
81
+ | `--limit` | Max results (default 20) |
82
+ | `--min-score` | Minimum relevance score, 0-1 |
83
+ | `--aspect-ratio` | Filter by aspect ratio (1:1, 16:9, 9:16, 2:3, 3:4, 1:2, 2:1, 4:5, 3:2, 4:3) |
84
+ | `--tags` | Comma-separated tag names to filter by |
85
+ | `--output` | Output format: `json` \| `files` \| `md` |
86
+ | `--fields` | Comma-separated field names to include |
87
+ | `--full` | Include full metadata |
95
88
 
96
89
  ### `baker images get <id>`
97
90
 
@@ -107,34 +100,14 @@ baker images get j571abc123def --full
107
100
  baker images get --image-id j571abc123def
108
101
  ```
109
102
 
110
- ### `baker images search <query>`
111
-
112
- Semantic search using hybrid BM25 + vector + reranking.
113
-
114
- ```bash
115
- # Basic search
116
- baker images search "hero banner"
117
-
118
- # Limit results and set minimum relevance
119
- baker images search "team photo" --limit 5 --min-score 0.3
120
-
121
- # Include scoring explanation (BM25, vector, rerank scores)
122
- baker images search "logo" --explain
123
-
124
- # Full metadata with markdown output
125
- baker images search "product shot" --full --output md
126
- ```
127
-
128
103
  **Flags:**
129
104
 
130
- | Flag | Description |
131
- |---------------|------------------------------------------|
132
- | `--limit` | Max results (default 20) |
133
- | `--min-score` | Minimum relevance score, 0-1 |
134
- | `--explain` | Include per-result scoring breakdown |
135
- | `--output` | Output format: `json` \| `files` \| `md` |
136
- | `--fields` | Comma-separated field names to include |
137
- | `--full` | Include full metadata |
105
+ | Flag | Description |
106
+ |--------------|----------------------------------------------|
107
+ | `--image-id` | Image ID (alternative to positional arg) |
108
+ | `--output` | Output format: `json` \| `files` \| `md` |
109
+ | `--fields` | Comma-separated field names to include |
110
+ | `--full` | Include full metadata |
138
111
 
139
112
  ### `baker images upload <file>`
140
113
 
@@ -158,9 +131,9 @@ baker images upload ./logo.png --dry-run
158
131
 
159
132
  | Flag | Description |
160
133
  |------------------|------------------------------------------------|
161
- | `--source` | Source identifier |
134
+ | `--source` | Source identifier |
162
135
  | `--content-type` | MIME type (auto-detected from extension) |
163
- | `--dry-run` | Preview the operation without executing |
136
+ | `--dry-run` | Preview the operation without executing |
164
137
 
165
138
  Supported extensions: `.png`, `.jpg`, `.jpeg`, `.gif`, `.webp`, `.svg`, `.avif`
166
139
 
@@ -179,9 +152,10 @@ baker images delete j571abc123def
179
152
 
180
153
  **Flags:**
181
154
 
182
- | Flag | Description |
183
- |-------------|------------------------------------------|
184
- | `--dry-run` | Preview the operation without executing |
155
+ | Flag | Description |
156
+ |--------------|----------------------------------------------|
157
+ | `--image-id` | Image ID (alternative to positional arg) |
158
+ | `--dry-run` | Preview the operation without executing |
185
159
 
186
160
  ### `baker schema [command]`
187
161
 
@@ -190,7 +164,7 @@ Inspect command argument schemas for AI agent introspection.
190
164
  ```bash
191
165
  # List all available commands
192
166
  baker schema
193
- # { "ok": true, "data": { "commands": ["images.list", "images.get", ...] } }
167
+ # { "ok": true, "data": { "commands": ["images.search", "images.get", ...] } }
194
168
 
195
169
  # Get schema for a specific command
196
170
  baker schema images.search
@@ -201,10 +175,10 @@ baker schema images.search
201
175
 
202
176
  By default, image responses include only essential fields to minimize token usage:
203
177
 
204
- | Mode | Fields |
205
- |-----------|-------------------------------------------|
206
- | Default | `_id`, `name`, `imageUrl`, `status`, `tags` |
207
- | `--full` | All fields: dimensions, colors, palette, source, timestamps |
178
+ | Mode | Fields |
179
+ |-----------|------------------------------------------------------------|
180
+ | Default | `_id`, `name`, `imageUrl`, `description`, `tags` |
181
+ | `--full` | All fields: width, height, aspectRatio, dominantColor, imagePalette, source, createdAt |
208
182
 
209
183
  ## Error Codes
210
184
 
@@ -217,6 +191,22 @@ By default, image responses include only essential fields to minimize token usag
217
191
  | `NETWORK_ERROR` | Connection failed |
218
192
  | `INTERNAL_ERROR` | Unexpected server error |
219
193
 
194
+ ## Available Image Tags
195
+
196
+ Use these with `--tags` to filter image search results. Multiple tags can be comma-separated.
197
+
198
+ | Tag | Description |
199
+ |--------------------|--------------------------------------------------------------|
200
+ | `logo` | Singular company, product, or organizational logo |
201
+ | `profile-picture` | Portrait-style image featuring a person's face |
202
+ | `illustration` | Stylized, drawn, or vector artwork |
203
+ | `software` | UI, dashboards, app interfaces, or software captures |
204
+ | `product-shot` | Focused depiction of a tangible product |
205
+ | `team-photo` | Group of people posed together, such as company team imagery |
206
+ | `environment` | Backgrounds or scenes showcasing locations, offices, spaces |
207
+ | `iconography` | Icons, symbols, or small graphical elements |
208
+ | `textures` | Patterns, textures, or abstract visual surfaces |
209
+
220
210
  ## For AI Agents
221
211
 
222
212
  This CLI is designed for AI agent consumption. Key patterns:
package/dist/cli.js CHANGED
@@ -5,7 +5,7 @@ import { schemaCommand } from "./commands/schema.js";
5
5
  const main = defineCommand({
6
6
  meta: {
7
7
  name: "baker",
8
- version: "0.3.0",
8
+ version: "0.4.0",
9
9
  description: `AI-agent CLI for finding and managing images in Baker.
10
10
 
11
11
  Auth: Set BAKER_API_KEY (starts with bk_) and BAKER_API_URL environment variables.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@koda-sl/baker-cli",
3
- "version": "0.3.0",
3
+ "version": "0.4.0",
4
4
  "description": "AI-agent-first CLI for interacting with Baker",
5
5
  "type": "module",
6
6
  "bin": {