The jam-nodes Playground provides two ways to test nodes interactively:
- CLI - A command-line tool for quick testing during development
- Web - A browser-based UI for visual exploration and demos
When to Use Each
| Use Case | CLI | Web |
|---|
| Testing nodes during development | Best | Good |
| Exploring node inputs/outputs | Good | Best |
| CI/CD or scripted testing | Best | - |
| Demos and presentations | - | Best |
| Learning the node API | Good | Best |
Installation
npm install -g @jam-nodes/playground
Quick Examples
List all available nodes:
Run a node with mock data (no API keys needed):
Run a node with JSON input:
jam run conditional -i '{"condition":{"type":"equals","variableName":"x","value":"y"},"trueNodeId":"a","falseNodeId":"b"}'
Credential Management
Both CLI and Web interfaces support three credential sources:
- Environment variables - Most secure, recommended for production
- Encrypted local storage - Convenient for development
- Runtime prompts - One-off testing
Use jam init to generate an .env template with all supported credentials.
Next Steps
