Skip to main content
Potpie separates Potpie account auth from provider integration auth.
  • potpie login / potpie logout manage Potpie account credentials
  • potpie github, potpie linear, potpie jira, and potpie confluence manage provider-specific access
  • potpie auth is still present, but it is a deprecated alias surface

​
Potpie Account Auth

​
potpie login

potpie login [OPTIONS]
Sign in through browser-based Firebase session flow or store an API key explicitly.
OptionTypeDescription
--api-key, -kstrPotpie API key. Uses key auth instead of browser login.
--url, -ustrPotpie API base URL, only used with --api-key.
Examples: 
potpie login
potpie login --api-key "$POTPIE_API_KEY"
potpie login --api-key "$POTPIE_API_KEY" --url http://127.0.0.1:8001

​
potpie logout

potpie logout
Removes locally stored Potpie account credentials.

​
Integration Status

Use the shared status command to inspect integration state: 
potpie status
potpie status --verify
--verify performs lightweight API checks instead of only showing stored auth state.

​
GitHub

potpie github COMMAND
CommandPurpose
potpie github loginAuthenticate with GitHub using device flow.
potpie github logoutRemove stored GitHub credentials.
potpie github reposList GitHub repositories accessible to this CLI.

​
Linear

potpie linear COMMAND
CommandPurpose
potpie linear loginAuthenticate with Linear via OAuth (PKCE).
potpie linear logoutRemove stored Linear credentials.
potpie linear lsList connected Linear workspaces.
potpie linear selectSelect a workspace and team, then fetch issues in the terminal.

​
Notable Options

potpie linear login
OptionDescription
--forceRe-authenticate the active Linear workspace.
--addAdd an additional Linear workspace.
potpie linear select
OptionDescription
--org, -oWorkspace URL key or name.
--key, -kLinear team key.
--limit, -nMax issue count, default 10.

​
Jira

potpie jira COMMAND
CommandPurpose
potpie jira loginAuthenticate with Jira.
potpie jira logoutRemove stored Jira credentials.
potpie jira lsList connected Jira sites or projects, depending on profile.
potpie jira selectSelect a Jira project and fetch issues in the terminal.
potpie jira select
OptionDescription
--key, -kJira project key.
--limit, -nMax issue count, default 10.

​
Confluence

potpie confluence COMMAND
CommandPurpose
potpie confluence loginAuthenticate with Confluence.
potpie confluence logoutRemove stored Confluence credentials.
potpie confluence lsList connected Confluence spaces or instances.
potpie confluence selectSelect a space and fetch pages in the terminal.
potpie confluence select
OptionDescription
--key, -kConfluence space key.
--limit, -nMax page count, default 10.

​
Deprecated Surface: potpie auth

potpie auth still exists for backward compatibility.

​
Current guidance

  • use potpie github, potpie linear, potpie jira, or potpie confluence
  • use potpie status for auth state
  • avoid building new docs or scripts on top of potpie auth