🪢 Agentspace
agentspace.so
·
GitHub
·
npm @agentspace-so/ascli
Use agentspace.so to share a specific local folder or file with a human or another agent via a workspace link.
Data handling
Only the path the user explicitly names is uploaded. Do not default to uploading the current working directory unless the user clearly says so.
All network traffic goes to
agentspace.so
only. The skill does not call any other endpoint.
The skill does not read environment variables, shell history, or files outside the path the user specifies.
Choose the CLI path
Prefer the first path that is already available in the environment:
If
ascli
is already on
PATH
, use it directly.
Else if
npm
is available, install once with
npm install -g @agentspace-so/ascli@latest
, or run without installing via
npx @agentspace-so/ascli@latest
.
If neither
ascli
nor
npm
is available, stop and tell the user to install Node.js from nodejs.org first.
Do not pipe a remote script into a shell to install.
Share a path
Ask the user which folder or file to share if they have not named one explicitly. Do not assume
.
.
Run
ascli share --permission edit
with the user-specified path.
If the user asks for view-only access, use
--permission view
.
If you are using the repo-local CLI path, run
pnpm --filter @agentspace-so/ascli exec tsx src/index.ts share --permission edit
.
share
handles an unbound folder by creating a temporary workspace, syncing once, and returning a link — no separate
sync
step is needed.
Return the share URL directly to the user exactly as the CLI prints it.
Guardrails
Do not invent claim URLs, workspace URLs, or share URLs. Only return what the CLI prints.
Do not require a global install if
npx
already works.
Do not move the user into a different project just to use agentspace.so.
If the user asks to "share this folder" and the target is ambiguous, confirm the exact path before running.
If you need exact command variants, read
references/commands.md
.