Wekoya Code

An AI coding agent that runs in your terminal, reads and edits the files in your project, and bills in naira from a wallet you top up by bank transfer. This page takes you from nothing installed to a working session.

Ask these docs

Answers come from this page only. No sign-in needed, and questions are rate limited — if you are asked to slow down, wait a minute.

Install

Windows

In PowerShell or Command Prompt:

npm i -g wekoya-code

Close Wekoya first

Windows locks a running program's file, so npm cannot replace wekoya.exe while a Wekoya window is open. Close every one before installing or updating. If you see EPERM warnings, that is what happened — close them and run npm i -g wekoya-code --force.

macOS and Linux

curl -fsSL https://code.wekoya.tech/install | bash

This puts the binary in ~/.wekoya/bin and adds that folder to your PATH automatically. Open a new terminal afterwards. If you would rather set the PATH yourself, run the installer with WEKOYA_NO_MODIFY_PATH=1.

npm works here too, if you already have Node installed:

npm i -g wekoya-code

macOS security warning

If macOS says the binary "cannot be verified", clear the quarantine flag once: xattr -d com.apple.quarantine ~/.wekoya/bin/wekoya

Check it worked

wekoya --version

If your shell says command not found, the install directory is not on your PATH yet. Open a new terminal first — that is usually all it is.

wekoya login

A code appears in your terminal and a browser page opens. Confirm the code matches, approve it, and the terminal continues on its own. The key is stored on that machine only.

To sign a machine out, run wekoya logout. That removes the local key; it does not revoke it elsewhere. If a machine is lost, rotate the key from your dashboard instead — that invalidates it everywhere.

Add money

Wekoya is pay-as-you-go. There is no subscription and no minimum. You are charged per request, in naira, against a wallet balance.

wekoya account

This prints your balance and a dedicated account number. Transfer to that account number from any Nigerian bank app and the money lands in your wallet, usually within a minute. The account number is yours and does not change, so you can save it as a beneficiary.

Free credit when you set up

Adding your phone number and creating your account number puts ₦2,000 in your wallet to start with. Make your first transfer of any amount and that welcome credit is topped up to ₦5,000. Both are automatic — there is no code to enter.

Your balance is shown live in the CLI while you work, and each session shows what it has spent so far. Both are in naira, not dollars.

Models

Press ctrl+p in a session, or run wekoya models to list them. Every model is reached through Wekoya, so there are no API keys to paste and nothing to configure per provider.

Model names are used as wekoya/<name> — for example wekoya/claude-sonnet-5. Pick auto and Wekoya chooses a model that suits the request.

When you want	Try	Why
Cheap, fast edits	`claude-haiku-4-5`	Lowest cost per request; fine for small, well-described changes.
Everyday coding	`claude-sonnet-5`	The default choice for real work across a codebase.
Hard problems	`claude-opus-5`	Most capable, most expensive. Worth it when the others are stuck.
Long context	`gemini-3.5-flash`	Very large context window at a low price.
An alternative opinion	`gpt-5.6-sol`	Different model family; useful when one keeps missing the point.

The full list is longer than this table and changes as providers add models. It comes from the server, so new models appear without you updating anything.

Thinking mode

Some models can think before answering. In the model picker, models that support it offer levels — none, low, medium and high.

Thinking costs tokens, so it costs money. Use none or low for ordinary edits, and reach for high when the problem is genuinely hard — a subtle bug, a design decision, something with several moving parts.

On a low balance

Replies are capped to what your balance covers. If that cap is too small to leave room for both thinking and an answer, the request runs without thinking rather than failing.

Working in a project

Change into your project folder and start it:

cd my-project
wekoya

Describe what you want in plain language. The agent reads the files it needs, makes edits, and runs commands when you allow it. It works in the directory you started it in.

Selecting and copying text

Wekoya captures the mouse so it can handle clicks and scrolling. While it does, your terminal cannot do its own text selection. Two ways round it:

Select with the mouse, then press ctrl+c to copy the selection.
Press ctrl+x then m to hand the mouse back to the terminal. Selection then works exactly as it does anywhere else. Press it again to give the mouse back to Wekoya.

Images

Copy an image and paste it into the prompt. It appears as [Image 1] — the terminal cannot draw the picture itself — but the model does receive the actual image, so you can paste a screenshot of an error and ask what it means.

Commands

Command	What it does
`wekoya`	Start a session in the current folder.
`wekoya login`	Sign this machine in.
`wekoya logout`	Remove the key from this machine.
`wekoya account`	Balance, account number, recent spending.
`wekoya models`	List every model you can use.
`wekoya run "…"`	Run one instruction without opening the full session.
`wekoya stats`	Your usage over time.
`wekoya session`	List and resume past sessions.
`wekoya export`	Save a session to a file.
`wekoya upgrade`	Update to the newest version.
`wekoya uninstall`	Remove Wekoya and its data.

Add --help to any of them for the full options.

What it costs

You pay per request, based on how much text goes in and comes back. A short question costs a few naira. A long session across many files costs more, and the running total is shown as you work.

Three things drive the bill:

The model. The gap between the cheapest and the most capable is large.
How much context is sent. Long conversations resend their history each turn.
Thinking mode. Thinking tokens are billed like any other.

To spend less: start a fresh session when you change topic, use a cheaper model for simple edits, and leave thinking off unless the problem needs it.

If a request is refused

A message about your balance being too low means the wallet cannot cover even a short reply. Top up with wekoya account. You are never charged for a request that failed before it produced anything.

When things break

EPERM, or "package manager failed to install"

A Wekoya window was open while npm tried to replace the binary. Close every Wekoya window, then:

npm i -g wekoya-code --force

If it persists, your antivirus may have quarantined the file — allow the folder and reinstall.

The install script fails on a bad connection

The download is large. The installer retries and resumes on its own; if it gives up, run it again and it continues rather than starting over.

"command not found" after installing

Open a new terminal. The installer adds the folder to your shell profile, which existing terminals have already read. If it still fails:

export PATH="$HOME/.wekoya/bin:$PATH"

A model says it is unavailable

Model availability changes. Run wekoya models for the current list and pick another — the list comes from the server and only shows models that can actually be used.

The agent describes an edit instead of making it

Update to the newest version with wekoya upgrade. If it continues, tell us which model and what you asked for.

Updating

wekoya upgrade

Or, if you installed with npm:

npm i -g wekoya-code

Most improvements are on the server and reach you with no update at all — new models, pricing and fixes to how requests are handled apply the moment they ship.