Input Sources
ralph-starter can fetch specifications from various external sources, allowing you to turn tasks from your existing tools into built projects.
Available Sources
Built-in Sources
| Source | Description | Auth Required |
|---|---|---|
file | Local files and directories | No |
url | Remote URLs (markdown, HTML) | No |
pdf | PDF documents | No |
Integration Sources
| Source | Description | Auth Required |
|---|---|---|
figma | Figma designs, tokens, components, assets | Yes (API token) |
github | GitHub Issues | Optional (gh CLI or token) |
linear | Linear issues | Yes (API key) |
notion | Notion pages | Yes (API key) |
Usage
Basic Syntax
ralph-starter run --from <source> [options]
Examples
# From a URL
ralph-starter run --from https://example.com/spec.md
# From a local file
ralph-starter run --from ./requirements.pdf
# From GitHub Issues
ralph-starter run --from github --project owner/repo --label "sprint-1"
# From Linear
ralph-starter run --from linear --label "in-progress" --limit 5
# From Notion
ralph-starter run --from notion --project "Product Specs"
Configuration
Store credentials for integration sources:
# Set credentials
ralph-starter config set figma.token <your-token>
ralph-starter config set linear.apiKey <your-key>
ralph-starter config set notion.token <your-key>
ralph-starter config set github.token <your-token>
# View all config
ralph-starter config list
# Get specific value
ralph-starter config get linear.apiKey
# Remove
ralph-starter config delete linear.apiKey
Credentials are stored in ~/.ralph-starter/sources.json.
Source Commands
# List available sources
ralph-starter source list
# Get help for a source
ralph-starter source help github
# Test connectivity
ralph-starter source test linear
# Preview items from source
ralph-starter source preview github --project owner/repo
Common Options
| Option | Description |
|---|---|
--project <name> | Project/repo filter |
--label <name> | Label filter |
--status <status> | Status filter |
--limit <n> | Maximum items to fetch |
How It Works
- ralph-starter fetches items from the source
- Items are converted to a specification format
- The spec is saved to
specs/directory - Planning and building proceed as normal