ben-vargas

@ccusage/omni Implementation Plan

Unified usage tracking across all AI coding assistants

Overview

Goal: Create a new @ccusage/omni package that aggregates usage data from all existing ccusage CLI tools into a single, unified view.

Supported Sources (v1): | Source | Package | Data Directory | Env Override |

ben-vargas

Initial Setup (New Projects)

This guide walks through setting up a new project with the bare git repository + worktree structure.

Setup Steps

1. Clone as Bare Repository

# Clone and setup bare repository

ben-vargas

#!/bin/bash
# AI CLI tools wrapper for scheduled activation of usage windows
# Outputs JSON for machine-readable logs with human-friendly summaries

# ============================================================================
# CONFIGURATION - Update these values for your environment
# ============================================================================

# System paths
USER_HOME="/home/code"

ben-vargas

Initial Setup (New Projects)

This guide walks through setting up a new project with the bare git repository + worktree structure.

Setup Steps

1. Clone as Bare Repository

# Clone and setup bare repository

ben-vargas

{
  "custom_models": [
    {
      "model_display_name": "Claude Opus 4.5 Thinking Low [Proxy]",
      "model": "claude-opus-4-5-20251101(low)",
      "base_url": "http://localhost:8317",
      "api_key": "dummy-not-used",
      "provider": "anthropic"
    },
    {

ben-vargas

  {
    "custom_models": [
      {
        "model_display_name": "Claude Opus 4.5 [Proxy]",
        "model": "claude-opus-4-5-20251101",
        "base_url": "http://localhost:8317",
        "api_key": "dummy-not-used",
        "provider": "anthropic"
      },
      {

ben-vargas

Amp Model Override Cheat Sheet

How to Override the Default Model

Option 1: amp.model.sonnet (simple toggle)

{
  "amp.model.sonnet": true
}

ben-vargas

Git Bare Repository Worktree Workflow for Claude Code

🚨 CRITICAL: Understanding My Project Structure

I use a bare Git repository approach with Git worktrees extensively. Every subdirectory in my projects represents a different git branch as a worktree.

When you see a project like /home/code/projects/my-app/:

• my-app/ = project container (NOT a working tree)
• my-app/.bare/ = actual Git repository database
• my-app/.git = pointer file directing Git commands to .bare/

ben-vargas

Running AI CLI Tools with Cron for 5-Hour Usage Windows

The Challenge

Anthropic and OpenAI enforce a 5-hour usage window - once I make my first request, I have 5 hours fixed usage before the window expires. This meant:

• ❌ Unpredictable availability - window could expire mid-project or at random times during the work day
• ❌ Frustration when usage windows expire at unopportune times
• ❌ Consistent work schedule and usage window planning

ben-vargas

import { OpenAI } from "openai";
import { runGuardrails } from "@openai/guardrails";
import { z } from "zod";
import { Agent, AgentInputItem, Runner } from "@openai/agents";


// Shared client for guardrails and file search
const client = new OpenAI({ apiKey: process.env.OPENAI_API_KEY });

// Guardrails definitions