WSpaces Claude Integration

Integrate WSpace with Claude Code — automate issue management, projects, and documents via GraphQL API.

Installation

Prerequisites

• Claude Code (npm install -g @anthropic-ai/claude-code)
• WSpace API Key (from WSpace Settings > Apps)

Install via npm

npx wspaces-claude

Or install globally:

npm install -g wspaces-claude
wspace-install

This installs two slash commands into Claude Code:

• /wspace-setup — Set up WSpace integration for the current project
• /wspace-api — Interact with the WSpace GraphQL API

Usage

1. Project setup

Open Claude Code in your project with the API key:

cd my-project
export WSPACE_API_KEY="sk_live_your_key_here" && claude

Run setup:

/wspace-setup

The setup wizard will:

• Use the WSPACE_API_KEY from env (or prompt for one)
• Connect and fetch workspace context (teams, workflows, labels, members)
• Auto-detect bot identity via me query
• Generate CLAUDE.md with project-specific defaults
• Optionally enable auto-loop (5m / 10m / 30m)

No .env file is created. The API key is set per terminal session to support multiple bot instances.

2. Multiple bot instances

Run multiple Claude Code instances on the same project, each with a different bot:

# Terminal 1
export WSPACE_API_KEY="sk_live_bot1_key" && claude

# Terminal 2
export WSPACE_API_KEY="sk_live_bot2_key" && claude

Each instance auto-detects its own bot identity via me query. No conflicts — each bot only processes issues assigned to itself.

3. WSpace API commands

/wspace-api context                          # View workspace info + scopes
/wspace-api workspaces                       # List all workspaces
/wspace-api issues list                      # List issues
/wspace-api issues get --team IVT --code 3   # Get issue details
/wspace-api issues create --title "Bug fix"  # Create a new issue
/wspace-api issues update --id <id> --priority HIGH
/wspace-api projects list                    # List projects
/wspace-api documents list                   # List documents

Once set up, you don't need to pass --workspace or --team — defaults are loaded from CLAUDE.md.

4. Auto-implement workflow

Enable auto-loop so the bot automatically processes assigned issues:

/loop 5m /wspace-api issues list

Or select an interval during /wspace-setup.

Flow

User assigns issue to Bot
  -> Backlog/Todo
  -> [Bot picks up] -> In Progress (comments implementation plan)
  -> [User responds via comment]
    -> approve       -> Bot implements  -> In Review (comments results)
    -> analyze more  -> Bot researches  -> In Progress (comments findings)
    -> feedback      -> Bot revises     -> In Progress (comments new plan)
    -> reject        -> Bot confirms    -> Backlog
    -> question      -> Bot answers     -> In Progress
  -> [User reviews In Review & completes manually]

How it works

1. User creates an issue on WSpace and assigns it to the bot
2. Bot picks it up — moves to In Progress, analyzes the task, comments the implementation plan
3. User reviews the plan — responds via comment on the issue:
   • "ok, go ahead" -> bot implements the code
   • "analyze section X further" -> bot does more research
   • "revise the plan" -> bot updates the approach
4. Bot finishes implementation -> comments results + moves to In Review
5. User reviews and completes manually

The bot only processes issues explicitly assigned to it. It never self-assigns issues. Comment intent is understood via NLU — no keyword matching.

File structure

After setup, your project will contain:

my-project/
  CLAUDE.md         # WSpace config defaults (auto-generated)

Global Claude Code commands:

~/.claude/commands/
  wspace-api.md     # /wspace-api command
  wspace-setup.md   # /wspace-setup command

Setting up on another machine

npm install -g @anthropic-ai/claude-code
npx wspaces-claude

# Then in your project
export WSPACE_API_KEY="sk_live_your_key" && claude
/wspace-setup

API Reference

Endpoint

• https://api.wspaces.app/graphql

Authentication

Header: x-api-key: <API_KEY>

Scopes

| Scope | Description | |-------|-------------| | ISSUES_READ / WRITE | Read/write issues | | PROJECTS_READ / WRITE | Read/write projects | | DOCUMENTS_READ / WRITE | Read/write documents | | TEAMS_READ | Read teams | | MEMBERS_READ | Read members | | APPOINTMENTS_READ / WRITE | Read/write appointments |

Priority levels

NO_PRIORITY | URGENT | HIGH | MEDIUM | LOW