Skip to main content
Use the Nullspace skill when local coding agents should understand the Nullspace SDK, CLI, MCP server, sandbox primitives, and agent templates. The installed references include a warm-pool recipe for agents that need to prepare a custom template pool, wait for ready capacity, create sandboxes with prefer or require, then drain the pool after a burst.

Install From GitHub

npx skills add catamaran-research/nullspace --skill nullspace
Restart the coding agent if the skill does not appear immediately.

Install From A Checkout

Codex repo-local:
mkdir -p .agents/skills
cp -R skills/nullspace .agents/skills/nullspace
Codex user-local:
mkdir -p ~/.agents/skills
cp -R skills/nullspace ~/.agents/skills/nullspace
Claude Code project-local:
mkdir -p .claude/skills
cp -R skills/nullspace .claude/skills/nullspace
Claude Code user-local:
mkdir -p ~/.claude/skills
cp -R skills/nullspace ~/.claude/skills/nullspace

Always-On Project Context

Copy skills/nullspace/assets/project-AGENTS.md or skills/nullspace/assets/project-CLAUDE.md into a project when Nullspace should be persistent context, not only an invoked skill. Keep root project instructions short. Broad orientation belongs there; workflow details belong in the skill and its references.

MCP

Install the SDK with CLI and MCP extras:
python -m pip install "nullspace-sdk[cli,mcp]==0.1.9"
For Claude Code and Codex on a local laptop, install the project-local docs and MCP config pack after the SDK install:
cd /path/to/your/project
nullspace docs install --agent all
Use --agent claude-code or --agent codex when you only want one local agent surface. The command writes .nullspace/agent-docs/ and project-local agent instructions. For Claude Code it installs .claude/skills/nullspace; for Codex it installs .agents/skills/nullspace. It does not require an API key and does not edit user-level config files. If you are installing from the repository skill files manually instead of using nullspace docs install, copy:
cp skills/nullspace/assets/claude-mcp.json .mcp.json
For Codex manual setup, add the TOML block from skills/nullspace/assets/codex-config.toml to ~/.codex/config.toml. Start the coding agent from a shell where these are set:
export NULLSPACE_API_KEY=ns_live_...
export NULLSPACE_API_URL=https://api.your-nullspace-domain
For platform-specific setup and verification in Codex, Claude Code, Cursor, and VS Code, see the Local MCP guide.

Check Local Setup

From the installed skill directory:
scripts/nullspace_check.sh
For offline schema checks without hosted API validation:
NULLSPACE_CHECK_SKIP_DOCTOR=1 scripts/nullspace_check.sh
The script does not print API key values.