@agentled/cli 0.7.17 → 0.7.19

package/README.md

@@ -357,6 +357,21 @@ The CLI now includes dedicated command groups matching MCP domains:
 - `agentled models list`
 - `agentled clients feedback add|reply|validate|sync`
 
+## Credit Usage and Cost Drivers
+
+The CLI does not yet ship first-class credit-reporting commands. Until those
+land, agents should use the product UI, MCP tools, or external API:
+
+- UI: `https://www.agentled.app/en/{workspace}/account/billing/credits-usage`
+  shows the workspace credit breakdown and cost drivers.
+- MCP: `get_workspace_credits`, `get_workspace_credit_cost_drivers`, and
+  `get_workflow_credits`.
+- API: `GET /api/external/workspace/credits?period=rolling-30-days&include=costDrivers`
+  and `GET /api/external/workflows/{workflowId}/credits?period=rolling-30-days&include=costDrivers`.
+
+Always include the returned `period.label` / `period.display` when reporting a
+credit total.
+
 ## Running workflows
 
 Start a workflow execution by id:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentled/cli",
-  "version": "0.7.17",
+  "version": "0.7.19",
   "description": "CLI for Agentled — manage workflows, apps, and knowledge from the command line. Zero context-window cost for AI agents.",
   "type": "module",
   "main": "dist/index.js",
@@ -17,7 +17,7 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@agentled/core": "^0.2.10",
+    "@agentled/core": "^0.2.12",
     "commander": "^12.0.0"
   },
   "devDependencies": {

package/skills/agentled/SKILL.md

@@ -88,6 +88,35 @@ Do not block a working MCP-only task just because the local CLI is absent or old
 Only update/install the CLI when the task needs CLI-backed setup, local files,
 fixtures, tests, or builder-work commands.
 
+### Tool discovery and multi-workspace use
+
+Codex does not always preload the full Agentled MCP surface. If a tool seems
+"missing", search for the exact tool name before assuming the server or plugin
+is missing it. Common examples:
+
+- `get_knowledge_rows`
+- `get_knowledge_rows_by_ids`
+- `query_kg_edges`
+
+When this repo is used against multiple workspaces, prefer the
+workspace-specific MCP namespace for live work, for example
+`mcp__agentled_angelhive.*`, instead of relying on the generic `mcp__agentled`
+namespace.
+
+The generic stdio MCP server follows the CLI's active workspace from
+`~/.agentled/config.json`, and the current MCP session may cache that client.
+If you switch with `agentled auth use <workspace>`, reconnect or restart the AI
+client before expecting `mcp__agentled.*` to point at the new workspace.
+
+For CLI commands, make workspace targeting explicit when needed:
+
+```bash
+agentled auth current
+agentled auth use angelhive
+agentled --workspace angelhive workspace inspect
+AGENTLED_WORKSPACE=angelhive agentled workflows list
+```
+
 ### External builder setup
 
 When this session is acting as an external AI builder for Agentled work items,