AE Agent platform CLI for Agent, approval, archived conversation, automation, model, MCP, Skill, attachment, and user-memory work. Use when managing these resources, browsing Agent markets, handling approval requests and tasks, restoring archived conversations, creating scheduled automations, persis

ae agent CRITICAL — Before running any ae cli agent +<command command, you MUST first read the corresponding references/<command .md . The reference filename equals the command name without the leading + , for example +add mcp references/add mcp.md . CRITICAL — Before running hierarchical approval commands, read the matching resource reference: approval type.md , approval request.md , approval task.md , or approval effect.md . CRITICAL — Before running agent bundle , agent share , or agent submission commands, read references/agent distribution.md . Agent and Skill share IDs are not interchangeable. CRITICAL — Never guess record IDs (Agent / automation / model / MCP / Skill / submission / share / attachment). Always use the appropriate +list command to discover real IDs first. CRITICAL — Legacy Agent CRUD uses /api/sandbox/agent/ ; Agent distribution and generic approvals use CLI token only /api/cli/agent/v1/ and /api/cli/approval/v1/ . ae cli memory uses /api/cli/memory/v1/ . Do not use Web session or sandbox credentials for CLI token endpoints. AE CLI ( ae cli ) agent platform resource commands are invoked through: Agent resource commands live under the agent service. Quick help: User memory commands live under the memory service: Global AE CLI Rules Use this skill for Agent platform resource management: Agents, generic approvals, archived conversations, automations, models, MCP servers, Skills, attachments, the MCP/Skill market, Agent and Skill approval/share flows, and user memories. Read operations ( risk: read ) can run directly once required IDs are known. Write operations ( risk: write ) can run directly once required IDs and references are verified. High risk write operations ( risk: high risk write ) require explicit user authorization. Pass yes only after the user confirms. Prefer dry run before high risk write operations to inspect the request shape without executing. Local Agent runtime memory +mark used is silent internal usage accounting after an answer actually uses memory. Personal and company scope resources can be created/updated/deleted; company scope requires root/agent admin role; system resources are read only (exception: root users can approve/reject submissions and set company scope meta). Toggle operations on company/system resources only affect the current user's preference, not the global state. Never invent record IDs. Discover them with +list commands or accept them from the user. JSON flags must be valid JSON strings, usually wrapped in single quotes in shell. Global Parameters Parameter Description format <json\ table Output format. Default is JSON. host <url Override the active AE host. Available on every command and may be placed after the subcommand, e.g. ae cli agent +<command host <url . yes Skip confirmation for high risk write operations after explicit user authorization. dry run Show request details (method + URL + body) without executing. Output and Errors Successful commands return machine readable JSON by default. Use format table when a table is easier to scan. Envelope may include optional notice.host compat . Failed commands return { "ok": false, "error": { "type": "...", "message": "...", "hint": "..." } } and exit non zero. CRITICAL — Host compat (do this first): After each ae cli run, check stderr and notice.host compat . If either is present, open the user reply with a short ⚠️ version warning and quote the npm i g / npx skills add (or update cluster) lines verbatim , then present the business result. Soft tip; ok: true can still carry the notice. When to Use Use ae agent for all Agent platform resource work: Agents, conversations & automations : manage Agents, share immutable Agent snapshots, submit Agents for company publication, preview approval snapshots, find/restore archived conversations, and manage scheduled Agent automations. Models : list, add, delete, toggle custom models. MCP servers : list, add, delete, toggle MCP servers; browse the MCP market; set market meta. Approvals : discover versioned approval types, submit/query/cancel approval requests, and query/approve/reject approval tasks. Skills : list, add, delete, toggle Skills; browse the Skill market; set market meta; copy system/company Skills to personal; use legacy company publish approval commands during the compatibility period; share/accept/reject peer to peer Skills. Attachments : list, upload, soft delete sandbox files in the attachment library. User Memory : recall, account for, create, update, extract, organize, preview, and initialize long term user memories through the memory domain. If the user's intent is data analysis, audience management, metadata governance, TeamRuns, or knowledge bases, switch to ae analysis / ae engage / ae dataops / ae team / ae kb . Tool Groups (89 commands) Agents (6) +list agents ([doc](references/list agents.md)) — list Agents visible to current user (personal/company/system) +create agent ([doc](references/create agent.md)) — create a new Agent (personal/company scope; company requires root/agent admin; name/description/instructions/model/mcp ids/skill ids) +update agent ([doc](references/update agent.md)) — update an Agent's name/description/instructions/model/mcp ids/skill ids/enabled +del agent ([doc](references/del agent.md)) — soft delete a personal/company Agent (company requires root/agent admin; system Agents cannot be deleted) +get agent ([doc](references/get agent.md)) — get a single Agent's detail +get agent context ([doc](references/get agent context.md)) — resolve instructions and dependency discovery for local execution; use ae use agent for the workflow Agent Distribution (7) Read [the complete share and company publication workflow](references/agent distribution.md) first. bundle preview — check current dependencies without creating a share or submission share recipients — find eligible same company recipients, including as an ordinary member share create — send an immutable personal Agent snapshot to selected recipients share list — list received/sent shares, pagination, versions, and allowed actions share accept — create or strictly reuse personal Agent and bundled Skill copies share reject — reject a received share without creating assets submission preview — read the authorized immutable approval snapshot, including after rejection Company submission, cancellation, approval, rejection, and execution retry reuse the Generic Approval Workflow below with agent.publish@1 . Archived Conversations (2) +find archived conversations ([doc](references/find archived conversations.md)) — find archived conversations for the current/specified Agent or explicitly across all Agents, with user facing timestamps converted by time zone +restore conversation ([doc](references/restore conversation.md)) — idempotently restore one archived conversation by conversation id Automations (3) +list automations ([doc](references/list automations.md)) — list current user's Agent automation tasks +create automation ([doc](references/create automation.md)) — create an Agent automation task (hourly/daily/weekly/monthly or cron) +update automation ([doc](references/update automation.md)) — update an automation's name, instruction, schedule, or enabled state Models (6) +list models ([doc](references/list models.md)) — list models visible to current user (personal/company/system) +add model ([doc](references/add model.md)) — add a custom model (personal/company scope; company requires root/agent admin) +update model ([doc](references/update model.md)) — update a custom model (personal/company scope; company requires root/agent admin; apiKey left blank to keep existing) +del model ([doc](references/del model.md)) — delete a personal/company model (company requires root/agent admin) +toggle model ([doc](references/toggle model.md)) — enable or disable a model +test model ([doc](references/test model.md)) — test custom model connectivity (LLM only) MCP Servers (13) +list mcps ([doc](references/list mcps.md)) — list MCP servers visible to current user +add mcp ([doc](references/add mcp.md)) — add an MCP server (personal/company scope; company requires root/agent admin) +update mcp ([doc](references/update mcp.md)) — update an MCP server's config (url/transport/headers/auth mode; connectivity validated) +del mcp ([doc](references/del mcp.md)) — delete a personal MCP server +toggle mcp ([doc](references/toggle mcp.md)) — enable or disable an MCP server +mcp tools ([doc](references/mcp tools.md)) — list tools provided by an MCP server (OAuth auto refresh) +mcp auth start ([doc](references/mcp auth start.md)) — start OAuth authorization (cliMode; print authorizeUrl, then poll with +mcp auth status) +mcp auth status ([doc](references/mcp auth status.md)) — query OAuth status (not required/needs auth/authenticated/reauth required/disabled) +mcp auth disconnect ([doc](references/mcp auth disconnect.md)) — disconnect OAuth, clear token and disable +list mcp credentials ([doc](references/list mcp credentials.md)) — list per user credentials for system MCPs +set mcp credential ([doc](references/set mcp credential.md)) — upsert a per user MCP credential (oauth/apikey) +mcp token ([doc](references/mcp token.md)) — get the shared MCP token (useMcpToken=true; plaintext, mind shell history) +mcp stats ([doc](references/mcp stats.md)) — MCP call stats for recent N days ( days 1 365 default 30; by server / by day) Skills (4) +list skills ([doc](references/list skills.md)) — list Skills visible to current user +add skill ([doc](references/add skill.md)) — create a custom Skill (personal/company scope; company requires root/agent admin) +del skill ([doc](references/del skill.md)) — delete a personal Skill (physical delete) +toggle skill ([doc](references/toggle skill.md)) — enable or disable a Skill Skill content & assets (15) +edit skill ([doc](references/edit skill.md)) — edit a Skill's content (name/description/instructions/category/icon) +get skill content ([doc](references/get skill content.md)) — read a Skill's SKILL.md source +list skill assets ([doc](references/list skill assets.md)) — list asset files of a Skill +upload skill asset ([doc](references/upload skill asset.md)) — upload an asset file ( isDangerousFile checked; 1MB) +read skill asset ([doc](references/read skill asset.md)) — read an asset file (binary safe with output ) +del skill asset ([doc](references/del skill asset.md)) — delete an asset file +list skill references ([doc](references/list skill references.md)) — list all reference files +upload skill reference ([doc](references/upload skill reference.md)) — upload a non dangerous reference file (1MB) +read skill reference ([doc](references/read skill reference.md)) — read text directly or save binary content with output +del skill reference ([doc](references/del skill reference.md)) — delete a reference file +list skill scripts ([doc](references/list skill scripts.md)) — list script files of a Skill +upload skill script ([doc](references/upload skill script.md)) — upload a script file ( isDangerousFile checked; 1MB) +read skill

ae-agent