How do I install the Omni Usage Logs skill?

Run npx skillmds@latest add publieople/omni-usage-logs in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Omni Usage Logs safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Omni Usage Logs?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Omni Usage Logs free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Omni Usage Logs?

publieople (@publieople) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Omni Usage Logs by publieople — Agent Skill

Name: Omni Usage Logs
Author: publieople

File contents

Overview

Access detailed call logs and usage analytics. Filter by provider, model, time range, status, and cost. Export logs and aggregate token usage across all connections.

Authentication

All requests require a valid Bearer token or session cookie. Obtain a token via POST /api/auth/login or configure REQUIRE_API_KEY=false for local development.

Endpoints

GET /api/usage/analytics

Get usage analytics

curl https://localhost:20128/api/usage/analytics \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/usage/call-logs

Get call logs

curl https://localhost:20128/api/usage/call-logs \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/usage/call-logs/{id}

Get a specific call log

curl https://localhost:20128/api/usage/call-logs/{id} \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/usage/{connectionId}

Get usage for a specific connection

curl https://localhost:20128/api/usage/{connectionId} \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/usage/history

Get usage history

curl https://localhost:20128/api/usage/history \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/usage/logs

Get usage logs

curl https://localhost:20128/api/usage/logs \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/usage/proxy-logs

Get proxy logs

curl https://localhost:20128/api/usage/proxy-logs \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/usage/request-logs

Get request logs

curl https://localhost:20128/api/usage/request-logs \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

GET /api/usage/budget

Get usage budget status

Returns current budget limits and consumption.

curl https://localhost:20128/api/usage/budget \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

POST /api/usage/budget

Configure usage budget

Set or update budget limits for usage tracking.

curl -X POST https://localhost:20128/api/usage/budget \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
  -H "Content-Type: application/json" \
  -d '{}'

Payloads

See the full OpenAPI specification at GET /api/openapi/spec or docs/openapi.yaml for detailed request/response schemas.

---name: omni-usage-logsdescription: Access detailed call logs and usage analytics. Filter by provider, model, time range, status, and cost. Export logs and aggregate token usage across all connections.---## OverviewAccess detailed call logs and usage analytics. Filter by provider, model, time range, status, and cost. Export logs and aggregate token usage across all connections.## AuthenticationAll requests require a valid Bearer token or session cookie. Obtain a token via `POST /api/auth/login` or configure `REQUIRE_API_KEY=false` for local development.## Endpoints### GET /api/usage/analyticsGet usage analytics```bashcurl https://localhost:20128/api/usage/analytics \ -H "Authorization: Bearer $OMNIROUTE_TOKEN"```### GET /api/usage/call-logsGet call logs```bashcurl https://localhost:20128/api/usage/call-logs \ -H "Authorization: Bearer $OMNIROUTE_TOKEN"```### GET /api/usage/call-logs/{id}Get a specific call log```bashcurl https://localhost:20128/api/usage/call-logs/{id} \ -H "Authorization: Bearer $OMNIROUTE_TOKEN"```### GET /api/usage/{connectionId}Get usage for a specific connection```bashcurl https://localhost:20128/api/usage/{connectionId} \ -H "Authorization: Bearer $OMNIROUTE_TOKEN"```### GET /api/usage/historyGet usage history```bashcurl https://localhost:20128/api/usage/history \ -H "Authorization: Bearer $OMNIROUTE_TOKEN"```### GET /api/usage/logsGet usage logs```bashcurl https://localhost:20128/api/usage/logs \ -H "Authorization: Bearer $OMNIROUTE_TOKEN"```### GET /api/usage/proxy-logsGet proxy logs```bashcurl https://localhost:20128/api/usage/proxy-logs \ -H "Authorization: Bearer $OMNIROUTE_TOKEN"```### GET /api/usage/request-logsGet request logs```bashcurl https://localhost:20128/api/usage/request-logs \ -H "Authorization: Bearer $OMNIROUTE_TOKEN"```### GET /api/usage/budgetGet usage budget statusReturns current budget limits and consumption.```bashcurl https://localhost:20128/api/usage/budget \ -H "Authorization: Bearer $OMNIROUTE_TOKEN"```### POST /api/usage/budgetConfigure usage budgetSet or update budget limits for usage tracking.```bashcurl -X POST https://localhost:20128/api/usage/budget \ -H "Authorization: Bearer $OMNIROUTE_TOKEN" -H "Content-Type: application/json" \ -d '{}'```## PayloadsSee the full OpenAPI specification at `GET /api/openapi/spec` or `docs/openapi.yaml` for detailed request/response schemas.

Frequently asked questions

Omni Usage Logs