Commands

Complete reference for all f2d CLI commands — search, configure, and config management

f2d search

Execute a semantic job search.

f2d search <query> [options]

Arguments

Argument	Type	Required	Description
`<query>`	string	Yes	Natural language search query

Options

Option	Type	Default	Description
`--city <city>`	string	—	Filter by city (exact match, case-sensitive)
`--country <code>`	string	—	Filter by country code (e.g. `US`, `GB`)
`--since <date>`	string	—	Earliest publish date (`YYYY-MM-DD`)
`--top-k <n>`	number	20	Number of results to return (1-100)
`--detail <level>`	string	`summary`	`summary` (default) or `full` (includes job description)
`--format <fmt>`	string	`table`	Output format: `table`, `json`, or `plain`
`--api-key <key>`	string	—	Override API key for this request
`--endpoint <url>`	string	—	Override API endpoint for this request

Examples

# Basic search
f2d search "machine learning engineer"

# Filter by city and limit results
f2d search "frontend developer" --city "New York" --top-k 5

# Filter by date
f2d search "data engineer" --since "2026-03-01"

# Full job descriptions
f2d search "product manager" --detail full --top-k 3

# JSON output for scripting
f2d search "Python developer" --format json | jq '.results[0]'

# Use a different API key for this request
f2d search "DevOps engineer" --api-key <other-key>

Output Formats

table (default)

A colored table with Score, Job Title, Company, City, Salary, Published, and URL columns:

Found 3 result(s):

┌─────────┬──────────────────────────────┬────────────────┬─────────┬───────────────────┬────────────┬──────────────────────┐
│ Score   │ Job Title                    │ Company        │ City    │ Salary            │ Published  │ URL                  │
├─────────┼──────────────────────────────┼────────────────┼─────────┼───────────────────┼────────────┼──────────────────────┤
│ 0.920   │ Senior Python Developer      │ Acme Corp      │ New York│ 125k-160k USD/YR  │ 2026-03-15 │ https://indeed.com/… │
│ 0.850   │ Python Software Engineer     │ Tech Inc       │ New York│ 90k-120k USD/YR   │ 2026-03-10 │ https://indeed.com/… │
└─────────┴──────────────────────────────┴────────────────┴─────────┴───────────────────┴────────────┴──────────────────────┘

json

Raw JSON matching the REST API response format. Ideal for piping to jq or other tools:

f2d search "Python developer" --format json | jq '.results[] | .job_title'

plain

One line per result, minimal formatting. Useful for simple scripts.

f2d configure

Interactive one-time setup. Run this after installation to save your API key.

f2d configure

Interactive flow:

$ f2d configure
? API Key: ****
? Endpoint [https://...]: (press Enter to accept default)

Configuration saved to ~/.f2drc

API key input is masked for security
The endpoint is pre-filled with the default value — just press Enter
Configuration is encrypted and saved to ~/.f2drc

f2d config set

Set a specific configuration value.

f2d config set <key> <value>

Available Keys

Key	Description
`api-key`	Your API key (stored encrypted)
`endpoint`	API base URL

Examples

# Update API key
f2d config set api-key <your-new-api-key>

# Set custom endpoint
f2d config set endpoint <your-endpoint-url>

f2d config list

Display current configuration. API keys are shown with masking for security.

f2d config list

Example output:

Configuration (~/.f2drc):

  api-key:   cfc6****f582
  endpoint:  https://...

Only the first 4 and last 4 characters of the API key are shown.

Global Options

These options are available for all commands:

Option	Description
`--help`	Show help for the command
`--version`	Show the f2d CLI version

f2d --help
f2d search --help
f2d config --help

Next Steps

Configuration — API key priority, security details, and FAQ
Installation — alternative install methods

On this page