Docs

Fikra Code docs

Sign in and keysPlans and limitsModelsConfigMCPPermissionsTroubleshooting

Sign in and keys

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.

$ fikra login

Over SSH or on a server, print the link instead of opening a browser:

$ fikra login --device-auth

For CI and scripts, use a key from the dashboard. Set it as an environment variable, or pipe it to login:

$ export FIKRA_API_KEY=fk_...
$ printenv FIKRA_API_KEY | fikra login --with-api-key

Check or remove the sign-in with fikra login status and fikra logout.

Plans and limits

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.

Models

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.

$ fikra -m fikra-auto "explain this repo"

All models: fikraapi.co.ke/code/models.

Config file

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

MCP servers

Connect tools over the Model Context Protocol.

$ fikra mcp add docs --url https://example.com/mcp

List them with fikra mcp list and remove one with fikra mcp remove <name>.

Permissions

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.

Troubleshooting

"DeepSeek free quota used up"

Wait for the time shown, or pick a plan at fikraapi.co.ke/code/plans.

"Your plan 5h allowance is used up"

The allowance resets at the time shown. Pay-as-you-go balance covers requests until then.

"This sign-in expired"

Run fikra login again. Links last two hours.

"You have N active keys"

Accounts can have 10 active keys. Revoke unused keys in the dashboard.

Every command asks for permission, or "the sandbox cannot start"

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.

Something else

Run fikra doctor, then email [email protected] with the output.