Elnora Admin & Diagnostics

Authentication, API key management, account settings, health checks, audit logs, feedback, and shell completions.

Tool Access

Elnora is available via two methods. Use whichever is configured.

Option A — CLI via Bash (preferred)

Run commands via your Bash/Shell tool as elnora <group> <action> .... Verify with elnora --version. CLI uses ~5× fewer tokens than MCP.

Option B — MCP tools (when CLI isn't installed)

Look for tools prefixed mcp__elnora__ in your available tools. Call them with structured parameters (camelCase — e.g. projectId, not project-id). See the "MCP Tool Names" table below for the mapping.

If neither is available, tell the user to install one:

• CLI: curl -fsSL https://cli.elnora.ai/install.sh | bash (macOS/Linux)

or irm https://cli.elnora.ai/install.ps1 | iex (Windows)

• MCP: claude mcp add elnora --transport http --scope user https://mcp.elnora.ai/mcp

then /mcp to authenticate.

Never fabricate tool names. Valid commands are in the Commands section; their MCP equivalents are in the MCP Tool Names table.

Invocation

CLI="elnora"

Authentication

Login

$CLI --compact auth login --api-key <KEY>
$CLI --compact auth login --api-key <KEY> --profile university

--api-key is required — there is no interactive prompt. Keys must start with elnora_live_ and be 20+ characters. Saves to ~/.elnora/profiles.toml.

Response: {"profile":"default","verified":true,"configPath":"/Users/<you>/.elnora/profiles.toml"}

Check Auth Status

$CLI --compact auth status
# -> {"profile":"default","authenticated":true,"projectCount":N}

Logout

$CLI --compact auth logout
$CLI --compact auth logout --all

Without --all, removes the current profile. With --all, removes all saved profiles from profiles.toml.

List Profiles

$CLI --compact auth profiles
# -> {"profiles":[{"name":"default","apiKey":"elnora_live_...abcd"}]}

Shows all configured profiles with masked API keys.

Validate Token

$CLI --compact auth validate
$CLI --compact auth validate --token <TOKEN>

Validates the current API key (or a specific token).

Who Am I

$CLI whoami
$CLI --json whoami

Shows current profile, masked API key, and organization name.

API Key Management

Create API Key

$CLI --compact api-keys create --name "CI Pipeline"
$CLI --compact api-keys create --name "Agent Key" --scopes "read,write"

IMPORTANT: The key value is only shown once in the response. Store it securely.

List API Keys

$CLI --compact api-keys list

Revoke API Key

$CLI --compact api-keys revoke <KEY_ID>
# -> {"revoked":true,"keyId":"..."}

Destructive — confirm with user first.

Get API Key Policy

$CLI --compact api-keys get-policy
# -> {"policy":"all_members"}

Set API Key Policy

$CLI --compact api-keys set-policy --policy admins_only
$CLI --compact api-keys set-policy --policy all_members

Org admin/owner only. Values: all_members or admins_only.

Account Management

Get Account

$CLI --compact account get <USER_ID>

<USER_ID> is positional. Get user IDs from account users.

Update Account

$CLI --compact account update <USER_ID> --first-name Jane --last-name Doe

Must provide at least one of --first-name or --last-name.

List Agreements

$CLI --compact account agreements

Accept Terms

$CLI --compact account accept-terms <DOCUMENT_VERSION_ID>

<DOCUMENT_VERSION_ID> is positional.

Delete Account

$CLI --compact account delete
$CLI --compact account delete --yes

DANGEROUS: Permanently deletes the user's account. Irreversible. Requires typing "DELETE" to confirm. Use --yes to skip (non-interactive/CI only).

List Users (SystemAdmin)

$CLI --compact account users
$CLI --compact account users --state Active
$CLI --compact account users --state Deleted --ref-code ABC123

Optional filters: --state (Active, Pending, Deleted), --ref-code.

Add Legal Document Version (SystemAdmin)

$CLI --compact account add-legal-doc --document-type TermsOfService --version "2.0" --content "Terms text..." --effective-date 2026-04-01

Update Legal Document Version (SystemAdmin)

$CLI --compact account update-legal-doc <VERSION_ID> --content "Updated terms..."
$CLI --compact account update-legal-doc <VERSION_ID> --effective-date 2026-05-01

<VERSION_ID> is positional. Must provide at least one of --content or --effective-date.

Delete Legal Document Version (SystemAdmin)

$CLI --compact account delete-legal-doc <VERSION_ID> --yes

<VERSION_ID> is positional. Requires confirmation unless --yes.

Feature Flags (SystemAdmin)

List Feature Flags

$CLI --compact flags list

Get Feature Flag

$CLI --compact flags get --key enable-new-editor

--key is a required flag (not positional).

Set Feature Flag

$CLI --compact flags set --key enable-new-editor --value true --yes

WARNING: Affects ALL users on the platform. Always use --yes in agent context.

Health & Diagnostics

Health Check

$CLI health

No auth required. Returns {"status":"ok","timestamp":"..."} on success. Exits 1 if unreachable (network error).

Doctor

$CLI doctor

Runs 10 diagnostic checks across three sections: CLI (API reachability, authentication, version currency, config permissions, AI server reachability, PATH configured), Claude Code (plugin enabled, skills installed, plugin version match), and MCP (server reachable). Each check reports pass / fail / warn / skip; the summary line shows the tally.

Open Platform

elnora open              # Opens platform (default)
elnora open docs         # Opens documentation
elnora open keys         # Opens API keys page
elnora open billing      # Opens billing page
elnora open github       # Opens GitHub repo

Audit Log

$CLI --compact audit list --org <ORG_ID>
$CLI --compact audit list --org <ORG_ID> --action "project.created" --user-id <USER_ID>
$CLI --compact audit list --org <ORG_ID> --page 2 --page-size 50

--org is a required flag. Optional filters: --action, --user-id.

Feedback

$CLI --compact feedback submit --title "Feature request" --description "Add batch export"

Both --title and --description are required.

Shell Completions

elnora completion bash >> ~/.bashrc
elnora completion zsh >> ~/.zshrc
elnora completion fish > ~/.config/fish/completions/elnora.fish

MCP Tool Names

All commands in this skill are auto-registered as MCP tools. The mapping is elnora <group> <action> → elnora_<group>_<action> (camelCase preserved; only dots are replaced with underscores).

Note: whoami, doctor, open, completion, update, setup, and all auth sub-commands are CLI-only — no MCP equivalents. Auth commands manage local profile storage and interactive prompts, which don't translate to a remote MCP server.

Agent Recipes

Verify setup:

$CLI health && $CLI --compact auth status

Rotate an API key:

$CLI --compact api-keys create --name "Replacement Key"
# Update .env with the new key, then:
$CLI --compact api-keys revoke <OLD_KEY_ID>