Teaching custom routes

Arka can learn persistent natural-language routes — phrase → skill mappings stored in ~/.config/arka/learned_routes.json. Learned routes are checked early in the router, before symbolic rules.

Teach a route

route_learn learn "deploy staging" "agent_code run deploy.sh"
route_learn learn "my dashboard" system_monitor

Natural language:

arka teach route "deploy staging" to "agent_code run deploy.sh"
arka learn that when I say "morning standup" means stock news
arka remember route "check disk" as disk_breakdown

Correct a routing mistake

After a request routes incorrectly, fix it from the last trace:

route_learn learn --from-trace --correct "stock news"

This pairs the trace input with the skill you intended.

Manage routes

Command	Description
`route_learn list`	List all learned routes
`route_learn delete <id-or-phrase>`	Remove a route
`route_learn test <phrase>`	Preview what a phrase would run

Natural language:

arka list learned routes

Placeholders

Use {args} in the skill line to capture trailing text:

route_learn learn "summarize repo" "github_repo activity {args}"
# "summarize repo Sumit884-byte/arka" → github_repo activity Sumit884-byte/arka

How matching works

Exact trigger matches run the skill line as-is.
Prefix matches append the remainder ("check servers in prod" → system_monitor in prod).
Longer triggers win over shorter ones.

Learned routes use zero LLM tokens. They are ideal for team-specific shortcuts and correcting recurring misroutes.

Routing concepts — symbolic rules and LLM fallback
CLI reference — route_learn subcommands

Routing & CLI

Agent & memory

Developer tools

Models & inference

Media & documents

Integrations

Finance & data

Workflows & productivity

More

Teaching custom routes

Teach a route

Correct a routing mistake

Manage routes

Placeholders

How matching works

​Teach a route

​Correct a routing mistake

​Manage routes

​Placeholders

​How matching works

​Related

Teach a route

Correct a routing mistake

Manage routes

Placeholders

How matching works

Related