Getting started

Hit Sign up in the header. You can use an email address or a social login — Voci uses Clerk for accounts, so the sign-in screen will look familiar. Signing up drops you straight into the new-issue form; signing in later takes you to your dashboard.

You do not need to give an address to make an account. Voci asks for one later, only when a step actually needs to be aimed at someone — see Representatives & sending.

Go to + New from the dashboard. You get one box and the question What's on your mind? Write it the way you'd tell a friend. There is a 4,000-character cap, which is far more room than you need — a solid paragraph is plenty.

Press Generate my plan. It takes a few seconds while Voci reads the issue, works out who can act, and builds the plan.

Voci works from what you give it. Three things make a noticeably better plan:

1. 01

   Say what is actually happening

   “The council is cutting library hours and closing two branches in my neighbourhood” beats “libraries are important”. Concrete decisions have decision-makers; topics don't.

2. 02

   Say where, if it's local

   Naming your city, county, or district lets Voci aim the steps at the right body — your city council rather than Congress.

3. 03

   Say if there's a deadline

   A vote next week, a hearing next month, a comment period closing. Voci sequences the plan around it and puts the time-sensitive step first.

What you don't need: correct terminology, the name of the official, the name of the committee, or any idea of what the process is. That is the work Voci is doing for you.

Every plan has three parts:

A summary

One or two plain sentences putting your issue back in your own terms. It is there so you can check Voci understood you before you act on anything it wrote.

A scope

Local, State, or National — which level of government actually decides this. It drives the filter tabs on your dashboard, and it is why the steps point where they point.

Three to six steps

Ordered, easiest and most impactful first. Each is a letter, a call, a petition, or a local action, and most name a target — the office or role the step is aimed at.

Nothing here is fixed. You work steps in any order, skip the ones you don't want, and every draft is editable. The original text you typed is kept too — Show original description on the plan page brings it back.

Occasionally Voci will decline to build a plan and explain why instead. That happens when a request is aimed at harming, harassing, exposing or deceiving someone rather than at moving a public decision — most often when the target is a private individual rather than an official or an institution.

It is not a judgement on how angry you are. Strong feeling, and sharp criticism of an official's public record, are fine. If you get a refusal, rephrase toward the decision you want changed and the body that decides it. The full rules are the community guidelines.

/app is home. It lists your issues, newest first, with progress on each. Around them:

• Filter tabs — All, Local, State, National. Issues created before scope existed appear only under All.
• Mine and Shared with you — plans you own, and plans someone added you to.
• Pick up where you left off — a nudge back into whichever plan still has steps outstanding.
• Latest updates — developments the background agent found on your issues, with a new badge until you read them. See Background updates.
• Your representatives — everyone Voci has matched to your address, plus local officials you saved. More on that.
• Petition requests — petitions other people have asked you to sign, with Sign and Dismiss.
• An impact line — how many letters and calls you have completed. It counts steps you ticked off, since a phone call leaves no other trace.