Configuration & Utilities | CLI Reference

Authentication

Authenticate with your API key from your workspace settings page. The key is stored locally in your config file.

Authenticate with Project Feed. Prompts for your API key and stores it locally.

Example

pf auth login

Remove stored credentials

Example

pf auth logout

Show current authentication status

Example

pf auth status

Config

Manage configuration values like default project and workspace.

Set a config value. Keys: apiKey, defaultWorkspace, defaultProject

Example

pf config set defaultProject abc123
pf config set defaultWorkspace my-team

Get a config value

Example

pf config get defaultProject

Show all config values

Example

pf config list

Show the config file location

Example

pf config path

Config is stored at ~/.config/project-feed/config.json (Linux/macOS) or %APPDATA%/project-feed/Config/config.json (Windows).

Profiles

Create multiple config profiles for different workspaces or accounts. Use --profile on any command to use a specific profile for that invocation.

Create a new config profile

Example

pf config profile create work

List all config profiles

alias: pf config profile ls

Example

pf config profile list

Switch to a config profile

Example

pf config profile use work
pf config profile use default    # switch back

Delete a config profile

alias: pf config profile rm

Example

pf config profile delete work

Example workflow

# Create a profile for your work workspace
pf config profile create work
pf config profile use work
pf config set apiKey pf_live_...
pf config set defaultWorkspace my-company

# Switch back to your default profile
pf config profile use default

# Or use a profile for a single command
pf projects list --profile work

Directory Linking

Link a directory to a project so you don't have to pass --project every time. Creates a .pf/config.json file in the current directory.

pf link my-project     # link by project slug
pf link abc123         # or by ID
pf unlink              # remove the link

When linked, commands like pf tasks list will default to that project.

Utilities

Dashboard, history, undo, browser access, project scaffolding, raw API access, and shell completions.

Show a dashboard summary: project count, task breakdown, overdue items, and unread notifications

Example

pf status

Show recent action history

Options

--limitnumberMax number of entries to show

Example

pf history --limit 5

Reverse your last create or edit. Restores previous state for edits, or deletes for creates. Deletes cannot be undone.

Example

pf undo

Open a resource in the browser

Options

--postbooleanTreat ID as a post identifier

--taskbooleanTreat ID as a task identifier

Example

pf open                    # open the project
pf open WR-42 --task       # open a task by identifier

Link the current directory to a project. Creates .pf/config.json so you can omit --project.

Example

pf link my-project         # by slug
pf link abc123             # by ID

Remove the project link from the current directory

Example

pf unlink

Create a new project and link it to the current directory. Interactive wizard with template selection.

Example

pf init

Guided onboarding wizard for first-time setup

Example

pf quickstart

Raw API access with your auth injected. Supports GET, POST, PATCH, DELETE.

Options

--datastringRequest body (JSON string)

--paramstringQuery parameter (key=value, repeatable)

Example

pf api GET /projects
pf api POST /posts --data '{"title": "Hello", "projectId": "abc123"}'

Generate shell completion scripts for bash, zsh, or fish

Example

eval "$(pf completion bash)"
pf completion zsh > ~/.zfunc/_pf
pf completion fish | source