Skip to main content
This is the fastest path from installing pz to getting useful output.

What the CLI expects

The Paperzilla CLI works against your existing Paperzilla account and projects. That means:
  • you need a Paperzilla account
  • you need at least one project
  • then pz can list projects, browse feeds, open papers, print markdown, and generate Atom feed URLs
If you installed pz first and have not set up Paperzilla yet, that is fine. Start with the web app once, then come back to the CLI.

Step 1: install pz

Follow the install instructions in the CLI guide.

Step 2: sign in

pz login
Paperzilla sends a one-time email code and stores your session locally for reuse.

Step 3: if you do not have an account yet

Go to paperzilla.ai and follow the quickstart. The short version:
  1. Describe what research you want to track.
  2. Review the proposed project setup.
  3. Save delivery.
  4. Confirm your email if prompted.
That creates both your account access and your first project.

Step 4: if you signed in but have no projects

Run:
pz project list
If you see no projects, create your first one in the web app:

Step 5: run your first useful commands

List projects:
pz project list
Browse a project feed:
pz feed <project-id>
Inspect a paper or feed item:
pz paper <paper-or-feed-id>
Print raw paper markdown:
pz paper <paper-id> --markdown
Get an Atom feed URL:
pz feed <project-id> --atom

If your project exists but has no papers yet

That usually means the project is still processing, paused, too narrow, or too strict. See:

Next docs