Help

Answers to common questions and fixes for common errors.

FAQ

What is Agenline?

A terminal-native policy boundary that controls what AI agents can do before they reach sensitive resources.

Do you store my upstream keys?

Upstream keys are encrypted at rest and scoped to individual agents.

Which actions can Agenline enforce?

.agen route permissions use [r], [w], [rw], [x], or [rwx]; JSON field allowlists and stripping; spend caps with max_amount and amount_field; case-sensitive !redlist payload blocking; and DENIED strike-to-ban honeypots.

Unauthorized / 401 errors

Run agen login, then agen init to initialize the local agent configuration.

Troubleshooting

403 redlist_blocked / 403 bastion_banned / 403 policy_banned

The request matched a case-sensitive !redlist literal or tripped a DENIED route strike threshold. Clear a policy ban with agen policy unban <policy> <target> or a Bastion ban with agen bastion unban <site_code> <target>.

402 quota_exceeded

Monthly free calls and referral bonus calls are exhausted. Blocked and denied calls never consume quota. Add wallet credit when the payment gateway is available or share your referral link for bonus allocation.

agen: command not found

Make sure your global npm bin folder is on PATH, then reopen the terminal.

A call was blocked unexpectedly

Inspect the policy, !redlist entries, Bastion manifest, and DENIED strike state.