jiraya workspace

Work with workspaces

SubcomandosCopiar link da seção

jiraya workspace getCopiar link da seção

Get workspace details

Prints the full details of a workspace. The argument accepts a full UUID, a slug, or a short UUID prefix (≥4 hex chars) as shown in 'workspace list'. If omitted, the current default workspace is used.

A frozen workspace (read-only until its subscription is regularized) shows FROZEN AT and FROZEN REASON in the table; the JSON carries frozen_at and frozen_reason, null while the workspace is active.

Uso

jiraya workspace get [workspace-id|slug|prefix] [flags]

Flags

jiraya workspace limitsCopiar link da seção

Show the workspace's usage limits and current usage

Lists every workspace usage limit with its current usage, the value configured on the workspace, and the effective limit — the most restrictive of the workspace value, the Jiraya Cloud entitlement, and the installation cap. A missing value means Unlimited.

Every member can read limits and their history. Limits are managed by the platform administration and cannot be changed from the workspace ('managed_by' is 'platform' in the JSON output).

Uso

jiraya workspace limits [workspace-id|slug|prefix] [flags]

Exemplos

jiraya workspace limits
jiraya workspace limits my-team --output json
jiraya workspace limits audit --key agents

Flags

jiraya workspace limits auditCopiar link da seção

Show who changed workspace limits, when, and from what to what

Uso

jiraya workspace limits audit [workspace-id|slug|prefix] [flags]

Flags

jiraya workspace listCopiar link da seção

List all workspaces you belong to

Lists the workspaces you belong to. When one of them is frozen (read-only until its subscription is regularized), the table adds FROZEN AT and FROZEN REASON columns; JSON entries always carry frozen_at and frozen_reason, null while the workspace is active.

Uso

jiraya workspace list [flags]

Flags

jiraya workspace mcpCopiar link da seção

Manage the workspace's MCP server library

Manages the workspace's library of MCP servers. A server added here is given to NO agent: it reaches an agent only when someone assigns it to that agent ('jiraya agent mcp add'), which also carries a per-agent on/off toggle. Same shape as workspace skills.

The stored configuration is write-only: reads return the server names and transports, never the urls, commands, headers, or env.

jiraya workspace mcp addCopiar link da seção

Add an MCP server to the workspace library (admin/owner only)

Adds an MCP server to the workspace library. It is assigned to no agent — use 'jiraya agent mcp add <agent-id> <server-id>' to give it to one.

The payload is a single server entry, the same object shape that sits under a name in "mcpServers". Prefer --server-config-file or --server-config-stdin: MCP entries routinely carry API tokens, and an inline value ends up in shell history and 'ps'.

Uso

jiraya workspace mcp add <server-name> [workspace-id|slug|prefix] [flags]

Exemplos

jiraya workspace mcp add linear --server-config-file ./linear.json
echo '{"url":"https://mcp.example"}' | jiraya workspace mcp add example --server-config-stdin

Flags

jiraya workspace mcp listCopiar link da seção

List the workspace's MCP servers

Lists the workspace MCP library by name and transport. The stored configuration itself is write-only and is never returned — to anyone, including owners — because MCP entries routinely embed API tokens and a session URL is a credential on its own.

Uso

jiraya workspace mcp list [workspace-id|slug|prefix] [flags]

Flags

jiraya workspace mcp removeCopiar link da seção

Remove an MCP server from the workspace library (admin/owner only)

Removes the server from the library and from every agent it was assigned to.

Uso

jiraya workspace mcp remove <server-id> [workspace-id|slug|prefix] [flags]

Flags

jiraya workspace mcp updateCopiar link da seção

Rename or replace a workspace MCP server (admin/owner only)

Renames a server, replaces its configuration, or both. Agents keep their assignment across a rename because assignments key off the server id, not its name.

Uso

jiraya workspace mcp update <server-id> [workspace-id|slug|prefix] [flags]

Flags

jiraya workspace memberCopiar link da seção

Manage workspace members

jiraya workspace member inviteCopiar link da seção

Invite a member to a workspace by email

Sends a workspace invitation to an email address. The invitee gets a pending invitation they must accept before they join — this does not add them instantly. The optional workspace argument accepts a full UUID, a slug, or a short UUID prefix (≥4 hex chars) as shown in 'workspace list'; if omitted the current default workspace is used (--workspace-id / JIRAYA_WORKSPACE_ID / profile default).

Role defaults to 'member'; pass '--role admin' to invite an admin. Owners cannot be invited.

Uso

jiraya workspace member invite <email> [workspace-id|slug|prefix] [flags]

Flags

jiraya workspace member listCopiar link da seção

List workspace members

Uso

jiraya workspace member list [workspace-id|slug|prefix] [flags]

Flags

jiraya workspace switchCopiar link da seção

Set the default workspace for this profile

Sets the default workspace for the current profile after verifying you have access to it. Accepts a full UUID, a slug, or a short UUID prefix (≥4 hex chars) as shown in 'workspace list'. Subsequent commands without --workspace-id or JIRAYA_WORKSPACE_ID will target this workspace.

Resolution priority (highest to lowest): --workspace-id flag, JIRAYA_WORKSPACE_ID env, profile default (set by this command).

For low-level use, 'jiraya config set workspace_id <id>' writes the same setting without verification.

Uso

jiraya workspace switch <workspace-id|slug|prefix>

jiraya workspace updateCopiar link da seção

Update workspace metadata (admin/owner only)

Uso

jiraya workspace update [workspace-id|slug|prefix] [flags]

Flags