How do I connect Vercel to codus?
Open Integrations in settings, find the Vercel card under Hosting + deployment, and click Connect. Vercel does not use a browser sign-in here, so the card walks you through making an access token on vercel.com, then you paste it in and click Connect. Once connected, codus has full access to your Vercel account: deployments, build and function logs, environment variables, and domains. You can ask an agent things like "show my last Vercel deployment's build log" or "list the env vars on my project".
Before you start
- You need a Vercel account. If you do not have one, create it during the steps below.
- You will create a token and copy it once. Vercel shows the token a single time, so keep the codus window handy to paste it straight back.
Steps
- Open the gear (⚙), click See all settings →, then click Integrations.
- Find the Vercel card and click Open Vercel tokens page. Your browser opens vercel.com/account/tokens.
- On that page, click Create Token near the top right. Sign in to Vercel first if it asks.
- For the token name, type codus so you remember what it is for.
- Under Scope, choose Full Account so codus can work across all your projects. To limit it to one team, pick that team instead.
- Under Expiration, choose 1 year so you do not have to reconnect often.
- Click Create Token, then click the copy button next to the token. Copy it now, because Vercel only shows it once.
- Come back to codus, paste the token into the box on the card, and click Connect.
How do I know it worked?
The card shows a green Connected as yourname label with your Vercel username. The card also reminds you: "Your token is stored encrypted on this Mac and is only ever sent to Vercel." If the token is later revoked on vercel.com, the card notices the next time codus comes to the front and returns to the disconnected state.
Common problems
- The Connect button did nothing. The box needs a token first. Paste the token you copied, then click Connect. The button stays disabled while the box is empty.
- My token was rejected. codus validates the token against Vercel when you connect. Re-create it with Full Account scope and paste the fresh token.
- I missed the token before it disappeared. Vercel only shows a token once. Go back to the tokens page, create a new one, and paste that.
- I want to disconnect. Click Disconnect and confirm. codus forgets the token; reconnect any time with a new one.