Install

Install Fikra Code.

One line on Linux or Windows. macOS builds are not available yet.

$ curl -fsSL https://fikraapi.co.ke/code/install.sh | sh

Requirements

Ubuntu 24.04: one-time sandbox fix

Ubuntu 23.10 and 24.04 block the user namespaces Fikra Code's sandbox needs, so every command asks for permission. The installer offers to fix this. If you skipped it, run once:

$ curl -fsSL https://fikraapi.co.ke/code/ubuntu-sandbox.sh | sudo sh

It installs one AppArmor rule that lets bubblewrap (the sandbox) create user namespaces, and changes nothing else. Undo with sudo rm /etc/apparmor.d/fikra-bwrap && sudo systemctl reload apparmor.

Verify, sign in, update, uninstall

Verify

$ fikra --version

Sign in

$ fikra login

Opens fikraapi.co.ke to pick a plan or continue free. On a server or over SSH: fikra login --device-auth prints the link instead.

Update

$ fikra update

Re-runs the installer. On Windows, run the PowerShell line again.

Uninstall

$ rm "$(command -v fikra)" && rm -rf ~/.fikra

Removes the binary and your local settings and sign-in.

Troubleshooting

"command not found: fikra"

Open a new terminal so your PATH updates, or check where the installer put the binary in its last lines of output.

"DeepSeek free quota used up"

The free tier allows 150 requests every 5 hours and 500 a week. Wait for the time shown, or pick a plan at fikraapi.co.ke/code/plans.

"Your plan 5h allowance is used up"

The plan allowance resets at the time shown. Pay-as-you-go balance, if you have any, keeps you going in the meantime.

"This sign-in expired"

Sign-in links last two hours. Run fikra login again.

Fikra Code asks permission for every command, or says the sandbox cannot start

On Ubuntu 23.10 and 24.04, run once: curl -fsSL https://fikraapi.co.ke/code/ubuntu-sandbox.sh | sudo sh. See Ubuntu 24.04 above.

The browser did not open

Copy the link Fikra Code prints and open it on any device, or use fikra login --device-auth.