spaycial

What this skill does

# Spaycial

Spaycial is a SaaS platform that helps manage and optimize spatial data. It's used by urban planners, GIS analysts, and other professionals who work with geographic information.

Official docs: https://docs.spaycial.com/

## Spaycial Overview

- **Space**
  - **Member**
- **Message**
- **Notification**
- **User**
- **File**
  - **Comment**
- **Task**
  - **Task Assignee**
- **Channel**
- **Integration**
- **Article**
- **Document**
- **Event**
- **Goal**
- **Project**
- **Update**
- **Form**
- **Dashboard**
- **Automation**
- **Whiteboard**
- **Wiki**
- **Resource**
- **Tag**
- **Custom Field**
- **Template**
- **Meeting**
- **Time Off Request**
- **Approval**
- **Invoice**
- **Payment**
- **Customer**
- **Quote**
- **Product**
- **Order**
- **Expense**
- **Vendor**
- **Contact**
- **Deal**
- **Campaign**
- **Lead**
- **Subscription**
- **Support Ticket**
- **Contract**
- **Certificate**
- **Training**
- **Poll**
- **Announcement**
- **Bookmark**
- **SOP**
- **Risk**
- **Issue**
- **Bug**
- **Test Case**
- **Release**
- **Sprint**
- **Incident**
- **Change Request**
- **Problem**
- **Knowledge Base Article**
- **Service Request**
- **Configuration Item**
- **Asset**
- **License**
- **Vulnerability**
- **Audit**
- **Compliance**
- **Policy**
- **Procedure**
- **Control**
- **Regulation**
- **Framework**
- **Standard**
- **Assessment**
- **Finding**
- **Recommendation**
- **Plan**
- **Budget**
- **Forecast**
- **Report**
- **KPI**
- **Metric**
- **Indicator**
- **Scorecard**
- **Strategy**
- **Objective**
- **Initiative**
- **Action Item**
- **Decision**
- **Request**
- **Reservation**
- **Booking**
- **Appointment**
- **Visit**
- **Check-in**
- **Check-out**
- **Delivery**
- **Shipment**
- **Inventory**
- **Purchase Order**
- **Return**
- **Warranty**
- **Review**
- **Rating**
- **Feedback**
- **Suggestion**
- **Complaint**
- **Inquiry**
- **Comment**
- **Like**
- **Share**
- **View**
- **Download**
- **Print**
- **Export**
- **Import**
- **Sync**
- **Backup**
- **Restore**
- **Archive**
- **Purge**
- **Lock**
- **Unlock**
- **Encrypt**
- **Decrypt**
- **Sign**
- **Verify**
- **Authenticate**
- **Authorize**
- **Delegate**
- **Escalate**
- **Notify**
- **Remind**
- **Approve**
- **Reject**
- **Verify**
- **Validate**
- **Invalidate**
- **Schedule**
- **Trigger**
- **Monitor**
- **Alert**
- **Diagnose**
- **Repair**
- **Update**
- **Upgrade**
- **Patch**
- **Configure**
- **Customize**
- **Integrate**
- **Deploy**
- **Test**
- **Debug**
- **Optimize**
- **Scale**
- **Secure**
- **Govern**
- **Comply**
- **Train**
- **Educate**
- **Certify**
- **Accredit**
- **Onboard**
- **Offboard**
- **Hire**
- **Fire**
- **Promote**
- **Demote**
- **Transfer**
- **Reassign**
- **Allocate**
- **Deallocate**
- **Assign**
- **Unassign**
- **Link**
- **Unlink**
- **Connect**
- **Disconnect**
- **Associate**
- **Disassociate**
- **Relate**
- **Unrelate**
- **Group**
- **Ungroup**
- **Merge**
- **Split**
- **Copy**
- **Move**
- **Rename**
- **Convert**
- **Transform**
- **Translate**
- **Localize**
- **Version**
- **Compare**
- **Restore**
- **Recover**
- **Rollback**
- **Forward**
- **Rewind**
- **Undo**
- **Redo**
- **Zoom In**
- **Zoom Out**
- **Pan**
- **Rotate**
- **Flip**
- **Crop**
- **Resize**
- **Adjust**
- **Filter**
- **Enhance**
- **Correct**
- **Clean**
- **Repair**
- **Format**
- **Style**
- **Theme**
- **Brand**
- **Personalize**
- **Customize**
- **Automate**
- **Orchestrate**
- **Simulate**
- **Model**
- **Analyze**
- **Predict**
- **Forecast**
- **Optimize**
- **Recommend**
- **Suggest**
- **Guide**
- **Assist**
- **Support**
- **Help**
- **Train**
- **Educate**
- **Inform**
- **Notify**
- **Alert**
- **Warn**
- **Advise**
- **Consult**
- **Coach**
- **Mentor**
- **Manage**
- **Control**
- **Govern**
- **Oversee**
- **Supervise**
- **Direct**
- **Lead**
- **Coordinate**
- **Collaborate**
- **Communicate**
- **Share**
- **Present**
- **Report**
- **Document**
- **Record**
- **Track**
- **Monitor**
- **Audit**
- **Inspect**
- **Review**
- **Evaluate**
- **Assess**
- **Measure**
- **Quantify**
- **Calculate**
- **Compute**
- **Estimate**
- **Project**
- **Plan**
- **Schedule**
- **Organize**
- **Prioritize**
- **Delegate**
- **Assign**
- **Allocate**
- **Budget**
- **Fund**
- **Invest**
- **Spend**
- **Save**
- **Earn**
- **Profit**
- **Loss**
- **Balance**
- **Reconcile**
- **Pay**
- **Collect**
- **Invoice**
- **Bill**
- **Charge**
- **Credit**
- **Debit**
- **Transfer**
- **Exchange**
- **Convert**
- **Value**
- **Price**
- **Cost**
- **Worth**
- **Benefit**
- **Risk**
- **Opportunity**
- **Threat**
- **Issue**
- **Problem**
- **Solution**
- **Decision**
- **Choice**
- **Option**
- **Alternative**
- **Strategy**
- **Tactic**
- **Plan**
- **Goal**
- **Objective**
- **Target**
- **Milestone**
- **Deadline**
- **Progress**
- **Status**
- **Outcome**
- **Result**
- **Impact**
- **Effect**
- **Cause**
- **Consequence**
- **Factor**
- **Element**
- **Component**
- **Part**
- **Piece**
- **Item**
- **Object**
- **Entity**
- **Attribute**
- **Property**
- **Value**
- **Data**
- **Information**
- **Knowledge**
- **Wisdom**
- **Insight**
- **Understanding**
- **Awareness**
- **Perception**
- **Perspective**
- **View**
- **Opinion**
- **Belief**
- **Assumption**
- **Hypothesis**
- **Theory**
- **Model**
- **Framework**
- **Standard**
- **Guideline**
- **Policy**
- **Procedure**
- **Process**
- **Workflow**
- **System**
- **Network**
- **Platform**
- **Application**
- **Software**
- **Hardware**
- **Device**
- **Tool**
- **Equipment**
- **Machine**
- **Vehicle**
- **Building**
- **Location**
- **Place**
- **Area**
- **Region**
- **Country**
- **World**
- **Universe**

Use action names and parameters as needed.

## Working with Spaycial

This skill uses the Membrane CLI to interact with Spaycial. Membrane handles authentication and credentials refresh automatically — so you can focus on the integration logic rather than auth plumbing.

### Install the CLI

Install the Membrane CLI so you can run `membrane` from the terminal:

```bash
npm install -g @membranehq/cli@latest
```

### Authentication

```bash
membrane login --tenant --clientName=<agentType>
```

This will either open a browser for authentication or print an authorization URL to the console, depending on whether interactive mode is available.

**Headless environments:** The command will print an authorization URL. Ask the user to open it in a browser. When they see a code after completing login, finish with:

```bash
membrane login complete <code>
```

Add `--json` to any command for machine-readable JSON output.

**Agent Types** : claude, openclaw, codex, warp, windsurf, etc. Those will be used to adjust tooling to be used best with your harness

### Connecting to Spaycial

Use `membrane connection ensure` to find or create a connection by app URL or domain:

```bash
membrane connection ensure "https://www.spaycial.com/" --json
```
The user completes authentication in the browser. The output contains the new connection id.

This is the fastest way to get a connection. The URL is normalized to a domain and matched against known apps. If no app is found, one is created and a connector is built automatically.

If the returned connection has `state: "READY"`, skip to **Step 2**.

#### 1b. Wait for the connection to be ready

If the connection is in `BUILDING` state, poll until it's ready:

```bash
npx @membranehq/cli connection get <id> --wait --json
```

The `--wait` flag long-polls (up to `--timeout` seconds, default 30) until the state changes. Keep polling until `state` is no longer `BUILDING`.

The resulting state tells you what to do next:

- **`READY`** — connection is fully set up. Skip to **Step 2**.
- **`CLIENT_ACTION_REQUIRED`** — the user or agent needs to do something. The `clientAction` object describes the required action:
  - `clientAction.type` — the kind of action needed:
    - `"connect"` — user needs to authenticate (OAuth, API key, etc.). This covers initial authentication a