/
Configuration & Utilities
Authenticate, configure profiles, link directories to projects, and use utility commands like history, undo, and raw API access.
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 loginRemove stored credentials
Example
pf auth logoutShow current authentication status
Example
pf auth statusConfig
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-teamGet a config value
Example
pf config get defaultProjectShow all config values
Example
pf config listShow the config file location
Example
pf config pathConfig 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 workList all config profiles
alias: pf config profile lsExample
pf config profile listSwitch to a config profile
Example
pf config profile use work
pf config profile use default # switch backDelete a config profile
alias: pf config profile rmExample
pf config profile delete workExample 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 workDirectory 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 linkWhen 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 statusShow recent action history
Options
--limitnumberMax number of entries to showExample
pf history --limit 5Reverse your last create or edit. Restores previous state for edits, or deletes for creates. Deletes cannot be undone.
Example
pf undoOpen a resource in the browser
Options
--postbooleanTreat ID as a post identifier--taskbooleanTreat ID as a task identifierExample
pf open # open the project
pf open WR-42 --task # open a task by identifierLink 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 IDRemove the project link from the current directory
Example
pf unlinkCreate a new project and link it to the current directory. Interactive wizard with template selection.
Example
pf initGuided onboarding wizard for first-time setup
Example
pf quickstartRaw 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