Riggr

Node catalog

All 16 nodes with real props, drivers, libs, and limits.

Node catalog

Full reference for every node — what it is, what it accepts, how it persists, what library renders it. To insert any of them, Ctrl K and type part of the name.

Content

Text

  • Kind: text · Icon: FileText
  • What it is: rich-text editor with Markdown support, built on TipTap. Calculates reading time (~200 words/min).
  • Persisted props: text, agentReadHint, agentWriteHint (notes for the agent about when to read / write).
  • Output port: text-stream (stream).
  • Limits: none in code — stored straight as a string in the .riggr.

Code

  • Kind: code · Icon: Code2 · Default: 520×400px
  • What it is: Monaco editor (same as VS Code), with local workers for TS, JS, JSON, CSS, HTML. Autocomplete, JSDoc, generics, type hints.
  • Persisted props: code, language, filePath (absolute path if tied to a file).
  • 27 configured languages: JavaScript, TypeScript, Python, Rust, Go, Java, C, C++, C#, HTML, CSS, SCSS, JSON, YAML, Markdown, SQL, Shell, Dockerfile, XML, plaintext, INI, TOML.
  • Detection by extension: .ts/.tsx → TypeScript, .py → Python, .rs → Rust, etc.
  • TypeScript compiler options applied: target: ESNext, moduleResolution: NodeJs, allowJs: true, strict: false, experimentalDecorators: true.
  • Output port: code-stream (stream).
  • Exposed capabilities: getCode, setCode, getLanguage, setLanguage, getFilePath, openFile, openFilePath.
  • Limits: no explicit size limit. JSX requires language: "typescript".

JSON

  • Kind: json · Icon: Braces
  • What it is: tree-style viewer + editor. Toolbar with Minify, Validate (runs in a Web Worker), Import (paste/upload).
  • Persisted props: json (serialized object).
  • Output port: json (object).
  • Limits: no explicit size limit.

Webview

  • Kind: webview · Icon: Globe · Default: 800×400px
  • What it is: embedded browser (<webview> from Chromium via Electron). Supports DevTools, device emulation (iPhone, iPad, Android), persistent browser profiles.
  • Persisted props: url, partitionId (isolation), profileId (global profile), device (mobile preset).
  • Output port: webview-console (stream) — captures console.log/warn/error.
  • Capabilities: loadUrl, goBack, goForward, reload, executeJavaScript, openDevTools.
  • Limits: no file:// (CSP). Cookies isolated per partition (use profiles to share).

Terminal

Terminal

  • Kind: terminal · Icon: TerminalSquare · Default: 520×400px
  • What it is: full-duplex interactive terminal with native PTY (node-pty), rendered by xterm.js with FitAddon.
  • Default shell: PowerShell on Windows, $SHELL on macOS/Linux (bash fallback).
  • Persisted props: cwd, history.
  • Ports: output (string-stream) and input (string-stream).
  • Capabilities: execute(command), getHistory(), getOutput().
  • Limits: 150,000 character scrollback (~150 KB ring buffer). No tabs.

Agent Terminal

  • Kind: agentTerminal · Icon: Bot · Default: 520×480px
  • What it is: specialized terminal that runs Claude Code (or Codex/Gemini/custom) and exposes connected nodes via MCP. See Agent Terminal guide.
  • Persisted props: cwd, history, cliConfig (type, command, env, args), claudeSessionId (UUID for resume).
  • Supported CLIs: claude-code, codex, gemini, custom.
  • Ports: output and input (string-stream).
  • Special: detects bad sessions (exits in <5s after --resume); double Ctrl+C to close; tree-kill on stop.

APIs

HTTP Client

  • Kind: request · Icon: Send
  • What it is: full HTTP client with history, auth (Bearer, Basic, API Key), multiple body types (JSON, text, XML, form-urlencoded, form-data, binary).
  • Methods: GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS, CONNECT, TRACE.
  • Persisted props: request (full config), responses (last 10).
  • Output port: http-response (object).
  • Auth detail:
    • bearer → Authorization: Bearer <token>
    • basic → Authorization: Basic <base64(user:pass)>
    • api-key → header or query, configurable key and value
  • Special: runs via main process (IPC) to bypass CORS/CSP. Default timeout 30s.

Database

  • Kind: databaseClient · Icon: Database · Default: 480×540px
  • What it is: universal client for Postgres, MySQL, SQLite, and MongoDB.
  • Drivers: pg, mysql2, better-sqlite3, mongodb.
  • Source: connection URL directly or a reference to a variable in .env (Env Node).
  • Persisted props: config (driver, source, name, default DB), history (last 50), lastQuery, selectedDatabase, selectedSchema.
  • Output port: query-result (object with columns, rows, rowCount, elapsedMs).
  • URL examples:
    postgresql://postgres@localhost:5432/mydb
mysql://root:password@localhost:3306/mydb
/path/to/app.db                            (SQLite)
mongodb://localhost:27017/mydb
  • Tabs: Connection, Schema, Query (Monaco editor), History.
  • Limits: capped at 1000 rows per result. No prepared statements.

Filesystem

File Explorer

  • Kind: fileExplorer · Icon: FolderTree · Default: 320×520px
  • What it is: workspace tree with search, per-file Git status, open external, create/rename/delete.
  • Persisted props: expanded (list of open paths), showHidden.
  • Output port: file-selected (string path).
  • Capabilities: getSelectedPath, openFile, createFile, deleteFile, rename.
  • Limits: max depth 8 levels (performance), recent files capped at 100.

Environment

  • Kind: env · Icon: FileKey2
  • What it is: .env editor with per-variable toggles and comment preservation.
  • Supported variants: .env, .env.example, .env.development, .env.test, .env.production, .env.staging, .env.local.
  • Persisted props: filePath only. Vars are read straight from the file.
  • Output port: env-vars (object map).
  • Parser: lines starting with # become a comment attached to the next var. Accepts single and double quotes.

DevTools

Git

  • Kind: git · Icon: GitBranch · Default: 400×520px
  • What it is: visual wrapper around the git CLI. History, commits, push/pull, time-travel checkout.
  • Persisted props: time-travel state (isTimeTraveling, traveledHash, originalHead, originalBranch).
  • Output port: git-ref (current HEAD).
  • Tabs: History, Commit, Remote.
  • Capabilities: getStatus, getLog, getCommit, stage, unstage, commit.
  • Limits: git must be on PATH. Local repos only.

Docker

  • Kind: docker · Icon: Container · Default: 460×520px
  • What it is: manager via dockerode. Containers, images, volumes, networks, compose.
  • Persisted props: none (state is runtime).
  • Output port: docker-event (stream) — start/stop/die events.
  • Tabs: Containers, Images, Volumes, Networks, Compose.
  • Capabilities: listContainers, startContainer, stopContainer, removeContainer, pullImage, composeUp, composeDown.
  • Special: stats streaming (CPU/mem) via docker stats. Detects docker-compose.yml in the workspace.
  • Limits: needs Docker daemon running. Windows: Docker Desktop with WSL2.

NPM Manager

  • Kind: npmManager · Icon: Package · Default: 400×520px
  • What it is: Node package manager. Auto-detects npm/yarn/pnpm/bun by lockfile.
  • Persisted props: tab (installed / search / scripts), outdatedOnly.
  • Output port: script-result (object { name, stdout, stderr, exitCode }).
  • Capabilities: install, uninstall, runScript, search (npm registry).
  • Limits: npm.org rate limit (~200 req/min).

Database

See APIs above — grouped there by affinity.

Process Manager

  • Kind: processManager · Icon: Zap · Default: 380×480px
  • What it is: embedded mini-pm2. Defines long-running scripts (dev server, watcher, worker), manages start/stop/restart, shows live logs.
  • Persisted props: configs (script list).
  • Each config: name, command, cwd, env, autoStart, restartOnExit, autoRestart.
  • Runtime state: running / starting / exited / crashed, with PID and uptime.
  • Output port: process-log (stream).
  • Capabilities: start, stop, restart, getLogs.
  • Limits: 500 lines of logs in memory. Always foreground (no detach).

Structural

Task

  • Kind: task · Icon: Clock · Default: 340×320px
  • What it is: prompt scheduler. Cron or seconds interval. Details in Scheduled tasks.
  • Persisted props: schedule ({ kind, value }), prompt, active, repeat, delegateTo.
  • Output port: task-fire (stream).
  • Capabilities: setSchedule, start, stop, getStatus.
  • Limits: 5-field cron (no seconds/year), no timezone (machine-local), one prompt per Task.

Group

  • Kind: group · Icon: Layers
  • What it is: visual frame around other nodes. Collapsible, with title and color.
  • Persisted props: nodeLabel, minimized, preMinimizeHeight, preMinimizeWidth, keepAliveChildren, grid.
  • No handles.
  • Special: keepAliveChildren: true keeps children mounted on collapse (preserves hooks/state).
  • Limits: no nested groups (causes layout issues).

One-line summary

Node One-liner
Text Markdown editor for notes and long prompts
Code Monaco editor across 27 languages
JSON Tree editor + validate + minify
Webview Embedded browser with DevTools and device emulation
Terminal Real terminal (PTY + xterm)
Agent Terminal Where Claude lives, via local MCP
HTTP Client Embedded Postman/Insomnia
Database Postgres/MySQL/SQLite/Mongo client
File Explorer Workspace tree with Git status
Environment .env editor
Git Log, commits, time travel
Docker Containers, images, compose
NPM Manager Packages and scripts (detects yarn/pnpm/bun)
Process Manager Mini-pm2 with live logs
Task Cron / interval firing prompts
Group Visual frame

Connector list lays out what each node pair lets the agent do.