ae-workspace

Original：🇺🇸 English

Translated

Manage AE AgentSpaces with ae-cli: resolve current workspace context, list or update workspace profiles, transfer files, configure Agent/MCP/Skill/knowledge-base capabilities, manage shared-space members, inspect activities, or scope automations and archived conversations. Use for the new Workspace product; legacy sandbox Workspace sync/model behavior is separate.

11installs

Sourcethinkingaiagenticengine/ae-cli

Added on2026-10-21

NPX Install

npx skill4agent add thinkingaiagenticengine/ae-cli ae-workspace

SKILL.md Content

View Translation Comparison →

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-id
```
supplied by the user or returned by
```
workspace 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 resolve
```
TE_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 list
```
and 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-run
```
and obtain explicit confirmation before passing
```
--yes
```
.
Treat file and workspace deletion as
```
high-risk-write
```
.
Shared AgentSpace provisioning is administrator-owned.
```
workspace create
```
creates only a personal AgentSpace.
```
ae-cli sync
```
and
```
ae-cli model
```
manage 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 the

ae-automation

Skill.

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.

ae-workspace

NPX Install

Tags

SKILL.md Content

ae-workspace

Targeting

Safety

Related domains

Transition record