FirstClassTree

Shapelessai — Development skill for Claude Code

Development community

The Shapeless agent surface: shapeless CLI, MCP server, API contract, Claude Code plugin.

How to install Shapelessai

This entry records only its repository, not the path inside it, so there is no exact command to give. Open FirstClassTree/shapelessai and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Shapelessai does

The Shapeless agent surface: shapeless CLI, MCP server, API contract, Claude Code plugin.

Alternatives in Development

Mempalace Init — Set up MemPalace — install the package, initialize a palace, register the MCP server with Cursor, and verify e 58.6k ★
Claude Context Mode — An MCP server that sits between Claude Code and these outputs 5.3k ★
04 Fix MCP Server — Prompt 04: Fix MCP Server Build 2.2k ★

README

Shapeless

[Shapeless](https://shapelessai.com) runs your social presence: it drafts, schedules, and publishes content across your connected platforms, holds your Brand Memory, and keeps standing agents working while you sleep.

This repo is the public home of the **agent surface**: the `shapeless` CLI, the MCP server, the [API contract for agents](docs/api-for-agents.md), the Claude Code plugin, and the issue tracker. Your agent or script drives a Shapeless account: create jobs and resume stuck ones, approve and publish posts, edit Brand Memory, manage the standing agents.

Install

npx shapelessai --help      # one-off
npm i -g shapelessai        # keeps `shapeless` on your PATH

Node 20 or newer.

Authenticate

Mint a key in the studio: **Settings -> API keys** (`/studio/settings`). Give it only the scopes the caller needs - `read`, `write`, or `publish`. Only `publish` can put content out.

shapeless login             # paste the key; we verify it and store it 0600
export SHAPELESS_API_KEY=slk_...   # or: env var, beats the stored key

Config lives in `~/.config/shapeless/config.json`. `SHAPELESS_BASE_URL` overrides the API host (default `https://shapelessai.com`). `shapeless logout` forgets the local copy; revoke the key itself in the studio.

Every command takes `--json` to print the raw API response, and `--help`.

Jobs: durable runs

A job is a run the server keeps going whether or not you stay connected - the right shape for agents and cron.

# Fire and forget
shapeless jobs create draft three posts about our beta launch

# Watch it live (tails the event stream, falls back to polling)
shapeless jobs create plan this week --label "Weekly plan" --budget 2.50 --watch

# Come back later
shapeless jobs list               # 200 newest; prints a cursor if older jobs exist
shapeless jobs list --before    # the next page back
shapeless jobs show           # transcript summary + outputs
shapeless jobs tail