cli-contexts

Overview

Manage context engineering configurations, RTK filter sets, and conversation sessions from the CLI. Apply context-relay settings and inspect active context pipelines.

Quick install

npm install -g omniroute   # or: npx omniroute
omniroute --version

Subcommands

context-eng

Example:

omniroute context-eng

context-eng analytics

Flags:

• --period <p>

Example:

omniroute context-eng analytics

context-eng caveman

Example:

omniroute context-eng caveman

context-eng config

Example:

omniroute context-eng config

context-eng show

Example:

omniroute context-eng show

context-eng set

Flags:

• --aggressiveness <n>
• --max-shrink-pct <n>
• --preserve-tags <list>

Example:

omniroute context-eng set

context-eng rtk

Example:

omniroute context-eng rtk

context-eng config

Example:

omniroute context-eng config

context-eng show

Example:

omniroute context-eng show

context-eng set

Flags:

• --token-budget <n>
• --reserve-pct <n>

Example:

omniroute context-eng set

context-eng filters

Example:

omniroute context-eng filters

context-eng list

Example:

omniroute context-eng list

context-eng add

Flags:

• --priority <n>
• --action <a>

Example:

omniroute context-eng add

context-eng remove <id>

Flags:

• --yes

Example:

omniroute context-eng remove <id>

context-eng test

Example:

omniroute context-eng test

context-eng raw-output <id>

Example:

omniroute context-eng raw-output <id>

context-eng combos

Example:

omniroute context-eng combos

context-eng list

Example:

omniroute context-eng list

context-eng get <id>

Example:

omniroute context-eng get <id>

context-eng assignments <id>

Example:

omniroute context-eng assignments <id>

contexts

Example:

omniroute contexts

contexts list

List all contexts

Example:

omniroute contexts list

contexts add <name>

Add a new context

Flags:

• --api-key <k>
• --api-key-stdin
• --access-token <t>
• --access-token-stdin
• --scope <s>
• --description <d>

Example:

omniroute contexts add <name>

contexts use <name>

Switch active context

Example:

omniroute contexts use <name>

contexts current

Show the active context (server, auth, scope)

Flags:

• --name-only

Example:

omniroute contexts current

contexts show <name>

Show context details

Example:

omniroute contexts show <name>

contexts remove <name>

Remove a context

Flags:

• --yes

Example:

omniroute contexts remove <name>

contexts rename <old> <new>

Rename a context

Example:

omniroute contexts rename <old> <new>

contexts export

Export contexts to JSON

Flags:

• --out <path>
• --no-secrets
• --include-secrets

Example:

omniroute contexts export

contexts import <file>

Import contexts from a JSON file

Flags:

• --merge

Example:

omniroute contexts import <file>

contexts migrate

Move legacy plaintext context credentials to the OS keychain

Flags:

• --yes

Example:

omniroute contexts migrate

sessions

Example:

omniroute sessions

sessions list

Flags:

• --user <u>
• --kind <k>
• --active
• --limit <n>

Example:

omniroute sessions list

sessions show <sessionId>

Example:

omniroute sessions show <sessionId>

sessions expire <sessionId>

Flags:

• --yes

Example:

omniroute sessions expire <sessionId>

sessions expire-all

Flags:

• --yes

Example:

omniroute sessions expire-all

sessions current

Example:

omniroute sessions current