Run fikra or fikra login. Your browser opens fikraapi.co.ke, where you pick a plan or continue free. Check that the code on the page matches your terminal, and Fikra Code signs in on its own.
Over SSH or on a server, print the link instead of opening a browser:
For CI and scripts, use a key from the dashboard. Set it as an environment variable, or pipe it to login:
Check or remove the sign-in with fikra login status and fikra logout.
When a limit is reached, Fikra Code shows when it resets. Pay-as-you-go balance covers requests after a plan allowance runs out. See limits per model.
The default model is DeepSeek V4.1 Flash (deepseek-v4-1-flash-economy-free). Pick another one per run, or inside a session with /model.
All models: fikraapi.co.ke/code/models.
Settings live in ~/.fikra/config.toml. Set FIKRA_HOME to use another folder. Every setting is optional.
model = "fikra-auto" # default model approval_policy = "on-request" # ask before risky commands [tui] notifications = true
Connect tools over the Model Context Protocol.
List them with fikra mcp list and remove one with fikra mcp remove <name>.
Commands run in a sandbox. By default Fikra Code asks before it runs anything that leaves the workspace or needs the network. Change this inside a session with /permissions. On Ubuntu 23.10 and 24.04 the sandbox needs a one-time fix: see the install guide.
Wait for the time shown, or pick a plan at fikraapi.co.ke/code/plans.
The allowance resets at the time shown. Pay-as-you-go balance covers requests until then.
Run fikra login again. Links last two hours.
Accounts can have 10 active keys. Revoke unused keys in the dashboard.
Ubuntu 23.10 and 24.04 block the sandbox by default. Run once: curl -fsSL https://fikraapi.co.ke/code/ubuntu-sandbox.sh | sudo sh. Details: install guide.
Run fikra doctor, then email [email protected] with the output.