neopoll is a lightweight tool for creating and managing polls with ease.

I built it because, during presentations or group sessions, I often wanted quick feedback from the audience. But setting up a poll with existing tools always felt clunky and slow. So, I built the tool I wished existed.

As engineers, we're comfortable with JSON and the command line — so why not use both to spin up a poll in under five minutes? That’s the idea behind neopoll.

I've tried to keep the pricing simple and tied directly to the usage.

Table of Contents

• Installation
• Quickstart
• Commands
• Other Handy Commands
• Pricing
• Help & Support

Installation

brew tap neosh11/neopoll-cli
brew install neosh11/neopoll-cli/neopoll

Quickstart

1. Authenticate

   # Primary flow: prompt for email → send OTP → prompt for token → save session
   $ neopoll login
   
   # If you already have an OTP:
   $ neopoll login --email you@example.com --token 123456
   

   This saves your Supabase session to ~/.neopoll/session.json.

2. Generate a sample poll file

   # writes to ./sample-poll.json by default
   $ neopoll generate-sample
   
   # or choose a path
   $ neopoll generate-sample --output=my-poll.json
   

   Edit the resulting JSON to define your own questions and options.

3. Start the poll

   $ neopoll start my-poll.json
   

   You’ll be prompted to choose a “room” password that participants must enter to join.
   The command will print your poll URL (e.g. https://poll.app/abc-123).

4. Control the live poll

   • Advance to the next question:

     $ neopoll next
     

   • Reveal the current answer:

     $ neopoll reveal
     

   • Stop the poll and pull down results:

     # defaults to ./results.json
     $ neopoll stop
     
     # or specify your own output path
     $ neopoll stop --output=my-results.json
     

   Participants’ votes will be saved locally for analysis.

5. Check your credits

   $ neopoll credits-get
   

   This will show your current credits balance.

6. Buy credits

   $ neopoll credits-buy
   

   This will prompt you to buy credits for your poll session.

7. Logout

   $ neopoll logout
   

Commands

Other Handy Commands

• neopoll logout — delete your saved session (you’ll have to login again).
• neopoll refresh-token — renew your session if your access token expires.
• neopoll completion [bash|zsh|fish|powershell] — install shell auto-completion.

For full details on any command:

$ neopoll help <command>

Pricing

Help & Support

If you have any questions or issues, please open an issue on GitHub.

Alternatively, you can reach out to me directly to my email.