olakai-ai/olakai

Olakai Developer Status Digest

This skill fetches your Olakai Coding IQ status and formats it as a clean in-terminal digest — monitoring health, personal spend, and budget — without leaving Claude Code.

Step 1: Check prerequisites

which olakai || echo "NOT_INSTALLED"

If the output is NOT_INSTALLED, tell the user:

The Olakai CLI is not installed. Run npm install -g olakai-cli then try again.

Stop here if not installed.

Step 2: Fetch status

olakai status --json 2>&1

Parse the output as JSON. The shape is:

{
  "localMonitor": {
    "workspaces": [
      { "tool": "claude-code", "agentId": "...", "workspacePath": "...", "configured": true }
    ]
  },
  "backend": {
    "identity": { "found": true, "displayName": "[email protected]", "identityCount": 2, "projectNames": ["Backend Services"] },
    "spend": { "mtdCents": 1208, "providers": [...], "forecastMonthEndCents": 4030, "forecastConfidence": "high" },
    "budget": { "found": true, "monthlyLimitCents": 5000, "alertThresholds": [80, 100], "usagePct": 24.2, "status": "ok", "forecastPct": 80.6 },
    "monitoring": { "agentCount": 2, "recentSessionCount": 14, "lastActivityAt": "2026-06-09T12:00:00Z" }
  },
  "backendError": null
}

backendError is one of: null, "not logged in", "session expired", "unreachable", or another error string.

Step 3: Format as a markdown digest

Use today's month and year in the heading (e.g., ## Olakai Status — June 2026).

Helper — formatting cents: divide by 100, show two decimal places. Examples:

• 1208 cents → $12.08
• 5000 cents → $50.00
• 0 cents → $0.00

Helper — formatting a timestamp as relative time:

• < 1 hour ago → "X minutes ago"
• 1–23 hours ago → "X hours ago"
• ≥ 24 hours ago → the date string

Monitoring section (always shown)

### Monitoring
- <tool display name>: ✓ configured (`<workspacePath>`)
- Last activity: <relative time> — <recentSessionCount> sessions this month

• Repeat a line for each workspace in localMonitor.workspaces.
• If localMonitor.workspaces is empty, show:

  ### Monitoring
  - This workspace is not monitored.
  

• tool display names: claude-code → "Claude Code", codex → "Codex CLI", cursor → "Cursor"
• If backend.monitoring is null (offline) or backend is null, omit the "Last activity" line.

Personal Spend section (show only if backend.identity.found = true)

### Personal Spend (<Month> MTD)
- Est. cost: **$<mtdCents formatted>**
- Forecast: ~$<forecastMonthEndCents formatted> by month-end *(<forecastConfidence> confidence)*
- Providers: <Provider 1> $<amount> · <Provider 2> $<amount>

• Omit the Forecast line if forecastMonthEndCents is null.
• Replace forecastConfidence label: "high" → "high", "medium" → "medium", "low" → "low", "insufficient_data" → omit the entire forecast line and note it in Action Items.
• Format each provider name with title case. Sort providers by spend descending.

Budget section (show only if backend.budget.found = true)

### Budget
- Limit: $<monthlyLimitCents formatted>/month
- Used: <usagePct>% ($<mtdCents formatted> of $<monthlyLimitCents formatted>)
- Forecast: <forecastPct>% by month-end <status indicator>

Status indicators:

• status = "ok" and forecastPct < 80 → no indicator
• status = "ok" and forecastPct >= 80 → ⚠️ (approaching limit)
• status = "warning" → ⚠️ (approaching limit)
• status = "exceeded" → 🚨 (limit exceeded)

Omit the Forecast line if forecastMonthEndCents is null.

Identity section (show only if backend.identity.found = true)

### Identity
- Recognized as: <displayName> (<identityCount> identities)
- Projects: <projectNames joined by ", ">

Omit the Projects line if projectNames is empty.

---

Step 4: Surface action items

Collect all applicable items and append an ### Action Items section at the end. Omit the section entirely if there are no items.

| Condition | Action Item | |-----------|-------------| | localMonitor.workspaces is empty | [ ] This workspace is not monitored. Run \olakai monitor init` to set it up.| |backendError = "not logged in"|[ ] Log in with `olakai login` to see your personal spend and budget.| |backendError = "session expired"|[ ] Your session has expired. Run `olakai login` to refresh.| |backendError = "unreachable"|[ ] Could not reach the Olakai backend. Local monitoring is still active. Check your network or try again later.| |backend.identity.found = false(and no backendError) |[ ] You are not yet recognized in Olakai Coding IQ. Your first session needs to be processed — this usually takes a few minutes after your first monitored session.| |backend.budget.status = "warning"|[ ] Your spend is approaching your budget limit ($<limit>). Forecast: <forecastPct>% by month-end. Contact your admin if you need a higher limit.| |backend.budget.status = "exceeded"|[ ] Your budget limit ($<limit>) has been exceeded. Contact your admin to request an increase.| |backend.spend.forecastConfidence = "insufficient_data"|[ ] Forecast not available yet — less than 5 days of spend data. Check back later.` |

---

Full example output

## Olakai Status — June 2026

### Monitoring
- Claude Code: ✓ configured (`/Users/alice/dev/my-project`)
- Last activity: 2 hours ago — 14 sessions this month

### Personal Spend (June MTD)
- Est. cost: **$12.08**
- Forecast: ~$40.30 by month-end *(high confidence)*
- Providers: Anthropic $10.20 · Cursor $1.88

### Budget
- Limit: $50.00/month
- Used: 24.2% ($12.08 of $50.00)
- Forecast: 80.6% by month-end ⚠️ (approaching limit)

### Identity
- Recognized as: [email protected] (2 identities)
- Projects: Backend Services

### Action Items
- [ ] Your forecast (80.6%) is approaching your budget limit ($50.00). Contact your admin if you need a higher limit.

---

Graceful degradation

| Situation | What to show | |-----------|--------------| | backend = null or backendError present | Show Monitoring section, skip Spend/Budget/Identity, put the error in Action Items | | budget.found = false | Skip Budget section entirely | | identity.found = false | Skip Personal Spend and Identity sections; add Action Item | | forecastMonthEndCents = null | Omit Forecast line from both Spend and Budget | | localMonitor.workspaces is empty | Show "not monitored" message; add Action Item | | CLI command fails (non-JSON output) | Show the raw error and suggest olakai login or olakai whoami |