@devspeak/cli

@devspeak/cli

Command-line interface for the DevSpeak technical translation API.

Installation

# From the monorepo root
cd packages/cli
npm install
npm link

# Or install globally (when published)
npm install -g @devspeak/cli

Setup

• Generate an API key from the DevSpeak dashboard (Settings → API Keys)
• Authenticate the CLI:

devspeak login
# Enter your API key when prompted

# Or pass it directly
devspeak login --key dsk_live_your_api_key_here

This saves your key to ~/.devspeakrc with permissions restricted to your user (chmod 600).

Usage

Optimize text

# Positional argument
devspeak optimize "We need a login page that works with Google and saves user data"

# Pipe from stdin
echo "We need a caching layer for our API" | devspeak optimize

# From a file
cat requirements.txt | devspeak optimize --format "Jira Tickets"

Options

Flag	Description	Default
-a, --audience <value>	Target audience	Senior Dev
-c, --context <value>	Tech context	Backend
-f, --format <value>	Output format	Technical Spec
-t, --tone <number>	Tone 0 (concise) to 100 (detailed)	75
-i, --instructions <text>	Custom instructions	—
-o, --output <file>	Write output to file	—
--json	Output raw JSON response	—

Audience values

Junior Dev, Senior Dev, Tech Lead, SRE, Data Engineer

Context values

Backend, Frontend, Mobile, Data/ML, DevOps

Format values

Technical Spec, Jira Tickets, API Design, RFC, Data Model, Prompt, Optimize

Examples

# Generate Jira tickets for a mobile feature
devspeak optimize "Add push notifications for order updates" \
  --audience "Tech Lead" \
  --context "Mobile" \
  --format "Jira Tickets" \
  --tone 80

# Create an API design doc and save to file
devspeak optimize "REST API for managing user subscriptions" \
  --format "API Design" \
  --output api-design.md

# Get concise output (tone < 50 triggers rewrite mode)
devspeak optimize "we need to make the app faster" --tone 30

# Pipe output as JSON for scripting
devspeak optimize "Add rate limiting to all endpoints" --json | jq '.data.output'

Configuration

# View current config
devspeak config show

# Change default endpoint
devspeak config set endpoint https://www.devspeak.dev

# Change default audience
devspeak config set audience "Tech Lead"

Config File

Stored at ~/.devspeakrc:

{
  "apiKey": "dsk_live_...",
  "endpoint": "https://www.devspeak.dev",
  "defaults": {
    "audience": "Senior Dev",
    "context": "Backend",
    "format": "Technical Spec",
    "tone": 75
  }
}

Environments

Environment	Endpoint
Production	https://www.devspeak.dev

Switch environments:

devspeak config set endpoint https://www.devspeak.dev