Skip to content

Jumpspace

Jumpspace helps a repository remember why work exists, where the implementation lives, which tests protect it, and what an agent should do next.

It is not a hosted service and it is not a replacement for your source docs. It is a thin, source-controlled graph that connects Markdown intent to code, tests, plans, verification records, drift checks, and agent handoff packets.

  • Create source-backed task blocks in Markdown.
  • Scan those blocks into a repo-local index.
  • Ask evidence questions without treating retrieval as an oracle.
  • Give Codex, Claude Code, or another coding agent a grounded work packet.
  • Bootstrap a graph from an existing messy repo.
  • Track durable plans, next steps, and verification evidence.
  • Detect code/doc drift in CI and propose repairs.
  • Publish JSON contracts and SDK types for automation.
Terminal window
npm install -D jumpspace
npx jumpspace init --auto
npx jumpspace add-skill --codex
npx jumpspace add-skill --claude
npx jumpspace scan
npx jumpspace find approval
npx jumpspace ask "How does approval work?"

Once a task is approved and has a durable plan, hand the work to an agent:

Terminal window
npx jumpspace work DOC-EXAMPLE-001 --json

Start with Why Jumpspace? for the thesis, then Getting Started for setup. If you are adding Jumpspace to an existing codebase, use New Repo Use for the clean onboarding path.

If you want Codex or Claude Code to run most of the workflow for you, read Using With Agents. You can give the agent a plain-English request and let it use Jumpspace commands for discovery, bootstrap, planning, execution packets, verification, and handoff.

Then read Task Blocks to understand the source format. The advanced guides cover bootstrap, planning, verification, retrieval, drift, CI, repair, and agent skills.

For scripting, use the CLI Reference and JSON Contracts pages before depending on a response shape.