使用方法
- 复制安装命令,在自己的智能体环境安装前先检查源码包。
- 从原始文档核对所需工具、凭据和支持的宿主。
- 说明输入材料与期望交付物,并对照来源检查输出。
npx skills add https://github.com/thinkingaiagenticengine/ae-cli --skill ae-workspace开始前需了解
- 安装不包含模型订阅、API 额度或访问文件的权限。
- 仓库星数和安装量反映活跃情况,不等于独立质量或安全测试。
按源仓库内容呈现,保留标题、案例、代码、表格、链接以及原文引用的演示图片。
ae-workspace
Use ae-cli workspace for AgentSpace operations. Here, workspace_id and --workspace-id always mean AgentSpace.id; they never mean the legacy sandbox Workspace.id or a filesystem directory name.
Before composing a workspace command, read references/commands.md. It contains the command matrix, mutation prerequisites, and file-transfer rules.
Targeting
- Prefer an explicit
--workspace-idsupplied by the user or returned byworkspace list. - Inside a run, the CLI may use
TE_AGENT_CURRENT_AGENT_SPACE_ID, derive the ID from the canonical/spaces/actived/<id>/.conversations/...runtime directory, or ask the server to resolveTE_AGENT_CONVERSATION_ID. - When both workspace and conversation are available, send both so the server can reject a scope mismatch.
- Outside a run, if the target is unknown, run
workspace listand select from real IDs. Never fall back to an account default.
Use workspace current to verify the resolved ID, space type, role, and capabilities before a multi-step mutation.
Safety
- Read the latest record or revision before mutations that require
--version. - Treat capability and membership changes as
high-risk-write; preview them with--dry-runand obtain explicit confirmation before passing--yes. - Treat file and workspace deletion as
high-risk-write. - Shared AgentSpace provisioning is administrator-owned.
workspace createcreates only a personal AgentSpace. ae-cli syncandae-cli modelmanage the legacy sandbox Workspace. In an AgentSpace runtime, use workspace capability commands instead.
Related domains
- Memory:
ae-cli memory ...uses the same strict AgentSpace target. - Automations: use
ae-cli automation ... --agent-space-id ...and follow theae-automationSkill. - Archived conversations:
ae-cli agent +find-archived-conversations|+restore-conversation --workspace-id ....
Transition record
Transition status: transitional Owning module: te-claude AgentSpace Current transport: CLI-token REST under /api/cli/workspace/v1 Gateway target: TBD Review after: 2026-12-01 Exit condition: equivalent stable Gateway capabilities exist; keep only commands that still add orchestration, file handling, safety, or stable typed output.

