// Tools

erectl learnings

Read the distilled learnings the router captures after tool runs and chats: vector-indexed memories the pre-dispatch retriever uses to inform later runs. The CLI surface is narrow today: fetch one learning with show, and list a workspace's learnings through the execution API.

Availability: erectl learnings list lists a project's learnings, scoped to a workspace with --workspace and filtered by text with --query; erectl learnings show fetches one by id. The text filter runs on the client: the router has no search endpoint, so list reads pages until it has enough matches.

Overview

The learnings command group provides CLI access to accumulated workspace learnings. Learnings are extracted automatically after tool executions and stored as vector-indexed memories that the pre-dispatch retriever uses to inform future executions.

Context-aware: learnings resolves the base URL, project id, and API key from the active erectl deployment. Pass --frontend-url to override for a one-off invocation.

Scope required: all learnings commands need an API key with the execution scope. See Scopes.

The --workspace flag accepts the workspace external id in the operator-facing form ws_<hex> (for example ws_8f2c1a04b9e7). Raw workspace UUIDs are not a user-facing surface and are not accepted here.

Usage Pattern

bash

                    erectl learnings list                          # Newest learnings in the project
erectl learnings list --workspace ws_<hex>       # Scoped to one workspace
erectl learnings list --query "rate limit"        # Rows whose summary, body or tags contain the text
erectl learnings show <lid>                       # Fetch one learning by id
                

show

Show full details for a single learning: the content body, source type, relevance score, and creation timestamp. Requires the execution scope (see Scopes).

bash

                    erectl learnings show <lid>
erectl learnings show <lid> -o json
                

Arguments

Argument	Description
`learning-id` (positional)	Learning external id (`lrn_<hex>`).

Response fields

ID, learning external id
Content, raw learning text
Workspace ID, workspace external id (when set)
Score, relevance score (when emitted)
Source Type, originating surface (tool / chat / operator)
Created, ISO 8601 timestamp

List a workspace

learnings list --workspace scopes the list to one workspace and prints the newest rows first; --limit caps the rows printed (default 50). The same list is one call on the execution API, with the project id and API key the active deployment uses and the execution scope:

bash

                    curl -sS \
  -H "Authorization: Bearer $EREBINE_API_KEY" \
  "$EREBINE_FRONTEND_URL/$EREBINE_PROJECT_ID/v1/exec/learnings?workspace_id=ws_8f2c1a04b9e7"
                

Scopes

All learnings commands require an API key with the execution scope. The router rejects requests from keys without it with HTTP 403. See Authentication for the full scope reference.

Scope	Why it is required
`execution`	Required. Gates the EEM execution surface, of which the learnings store is a member.

Examples

Find the learnings that mention a tool

bash

                    erectl learnings list --workspace ws_8f2c1a04b9e7 --query "git push" -o json \
  | jq -r '.data[] | .id + "  " + .summary'
                

Pipe a single learning into a downstream tool

bash

                    erectl learnings show <lid> -o json \
  | jq -r .body
                

erectl learnings

Overview

Usage Pattern

show

Arguments

Response fields

List a workspace

Scopes

Examples

Find the learnings that mention a tool

Pipe a single learning into a downstream tool

erectl CLI

EEM Overview

Authentication