Xpersona
agentCLAWHUBUnverified

CostHQ

Track agent session costs, file changes, and git commits with CostHQ. Enforces budget limits, tracks local models, and provides Enterprise SOC2 audit trails... Skill: CostHQ Owner: brian-mwirigi Summary: Track agent session costs, file changes, and git commits with CostHQ. Enforces budget limits, tracks local models, and provides Enterprise SOC2 audit trails... Tags: latest:4.0.0 Version history: v4.0.0 | 2026-06-09T18:27:46.036Z | user - Added Semantic Caching Proxy to intercept and cache API calls, reducing repeated costs. - Introduced granular session termination via the

OpenClaw
View on ClawHubHomepage

Rank

62

Safety

84

Downloads

4.3k

Updated

Oct 9, 2026

Version

4.0.0

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 4.3K downloads reported by the source. Last updated 10/9/2026.

Avoid when

  • Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor
Clawhubvendor · observed Oct 9, 2026
Protocol compatibility
OpenClawcompatibility · observed Oct 9, 2026
Adoption signal
4.3K downloadsadoption · observed Oct 9, 2026
Latest release
4.0.0release · observed Jun 9, 2026
Handshake status
UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s17935t6g2g6grny1r9yk1eze986zjyt:costhq
  1. Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
  2. Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-brian-mwirigi-costhq/snapshot"

Documentation

CLAWHUB

101,371 characters of source documentation, loaded on request.

Extracted files

3 files captured from the source.

SKILL.md

---
name: costhq
license: MIT-0
description: Track agent session costs, file changes, and git commits with CostHQ. Enforces budget limits, tracks local models, and provides Enterprise SOC2 audit trails via a web dashboard. v3.3.0 - Enterprise SOC2 Audit Logging and Local Models.
metadata: {"openclaw": {"homepage": "https://github.com/brian-mwirigi/costhq", "requires": {"bins": ["cs"]}, "install": [{"id": "npm", "kind": "node", "package": "costhq", "bins": ["cs"], "label": "Install costhq (npm)"}]}}
---

# Session Cost Tracking (CostHQ)

Track agent session costs, file changes, and git commits. Enforces budget limits, tracks local models (Ollama, vLLM), and provides detailed session analytics with a full web dashboard and tamper-evident SOC2 audit logging for Enterprise users.

**Latest: v4.0.0** - Added Semantic Caching Proxy and Granular Session Termination.

📦 [npm](https://www.npmjs.com/package/costhq) • ⭐ [GitHub](https://github.com/brian-mwirigi/costhq) • 📝 [Changelog](https://github.com/brian-mwirigi/costhq/blob/main/CHANGELOG.md)

## Installation

```bash
# 1. Install the CLI globally from npm
npm install -g costhq

# 2. Install the OpenClaw skill
clawhub install costhq
```

After installing, the `cs` command is available globally. The OpenClaw agent will automatically use it to track sessions.

> **Requirements:** Node.js 18+ and C/C++ build tools (needed to compile the embedded SQLite module).
>
> | OS | Install build tools |
> |---|---|
> | **Ubuntu/Debian** | `sudo apt-get install -y build-essential python3` |
> | **macOS** | `xcode-select --install` |
> | **Windows** | `npm install -g windows-build-tools` or install Visual Studio Build Tools |
> | **Alpine** | `apk add build-base python3` |
>
> Data is stored locally at `~/.costhq/sessions.db` (or `~/.CostHQ`).

## When to use

- **Always** start a tracked session at the beginning of a multi-step task
- **Always** log AI usage after each API call you make
- **Always** end the session when the task is complete
- Use `cs dashboard` to review session data, set up local models, or verify the audit trail (Enterprise).

## Commands

### Start tracking
```bash
# Agent mode (always use --json for structured output):
cs start "task description" --json --close-stale

# Resume if a session was left open (e.g. after a crash):
cs start "task description" --json --resume
```

### Log AI usage (after each API call)
```bash
# Standard cloud model (cost auto-calculated):
cs log-ai -p anthropic -m claude-sonnet-4 --prompt-tokens 8000 --completion-tokens 2000 --json

# Local model with compute duration (NEW in v3.3.0):
# Use --duration in seconds (120) or string (2m30s). Cost is based on registered $/hr rate.
cs log-ai -p ollama -m llama3 --tokens 4500 --duration 2m30s --local --json

# With all fields:
cs log-ai -p openai -m gpt-4o --prompt-tokens 5000 --completion-tokens 1500 -c 0.04 --agent "Research Agent" --json
```

**Agent Name:** Use `--agent "Agent Name"` to track which agent performed the wo

_meta.json

{
  "ownerId": "kn756bc007k4jgde4rdmc008d580tqt4",
  "slug": "costhq",
  "version": "4.0.0",
  "publishedAt": 1781029666036
}

skill-card.md

## Description:

Track agent session costs, file changes, and git commits with CostHQ, including budget limits, local model tracking, dashboard analytics, and Enterprise SOC2 audit trails.

This skill is ready for commercial/non-commercial use.

## Publisher:

[brian-mwirigi](https://clawhub.ai/user/brian-mwirigi)

### License/Terms of Use:

MIT-0

## Use Case:

Developers and engineering teams use CostHQ to track agent task sessions, log AI usage costs, review file and commit activity, manage budgets, and inspect activity through a local dashboard.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: CostHQ can record agent activity, usage details, file changes, commits, and repository metadata.

Mitigation: Install only in repositories where this monitoring is acceptable, prefer a pinned reviewed npm package version, and review collected session data before using it for audit or reporting.

Risk: The Semantic Caching Proxy intercepts API calls and may cache prompts or responses.

Mitigation: Avoid routing secrets, customer data, or regulated prompts through the proxy until retention, cache purge, and access-control behavior are clear.

Risk: Dashboard command controls can affect active tracked sessions and execute CostHQ CLI operations.

Mitigation: Restrict dashboard access to trusted users and avoid running installation or CostHQ commands with elevated privileges unless required.

## Reference(s):

- [CostHQ ClawHub Listing](https://clawhub.ai/brian-mwirigi/skills/costhq)
- [CostHQ GitHub Repository](https://github.com/brian-mwirigi/costhq)
- [CostHQ npm Package](https://www.npmjs.com/package/costhq)
- [CostHQ Changelog](https://github.com/brian-mwirigi/costhq/blob/main/CHANGELOG.md)

## Skill Output:

**Output Type(s):** [text, markdown, shell commands, configuration, guidance]

**Output Format:** [Markdown with bash command examples and JSON-oriented CLI guidance]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [Commands are expected to use --json and may read or write local CostHQ session data.]

## Skill Version(s):

4.0.0 (source: server release metadata; artifact heading also states Latest v4.0.0)

## Ethical Considerations:

Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.

Related agents

Same protocol, similar job.

Github ReposUpdated 5h agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW
Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW
Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.

MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular

OPENCLAW

Machine-readable data

The same record, as JSON, for agents and crawlers.

{
  "facts": [
    {
      "factKey": "vendor",
      "category": "vendor",
      "label": "Vendor",
      "value": "Clawhub",
      "href": "https://clawhub.ai/brian-mwirigi/skills/costhq",
      "sourceUrl": "https://clawhub.ai/brian-mwirigi/skills/costhq",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-09T05:34:47.557Z",
      "isPublic": true
    },
    {
      "factKey": "protocols",
      "category": "compatibility",
      "label": "Protocol compatibility",
      "value": "OpenClaw",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-brian-mwirigi-costhq/contract",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-brian-mwirigi-costhq/contract",
      "sourceType": "contract",
      "confidence": "medium",
      "observedAt": "2026-10-09T05:34:47.557Z",
      "isPublic": true
    },
    {
      "factKey": "traction",
      "category": "adoption",
      "label": "Adoption signal",
      "value": "4.3K downloads",
      "href": "https://clawhub.ai/brian-mwirigi/costhq",
      "sourceUrl": "https://clawhub.ai/brian-mwirigi/costhq",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-09T05:34:47.557Z",
      "isPublic": true
    },
    {
      "factKey": "latest_release",
      "category": "release",
      "label": "Latest release",
      "value": "4.0.0",
      "href": "https://clawhub.ai/brian-mwirigi/costhq",
      "sourceUrl": "https://clawhub.ai/brian-mwirigi/costhq",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-06-09T18:27:46.036Z",
      "isPublic": true
    },
    {
      "factKey": "handshake_status",
      "category": "security",
      "label": "Handshake status",
      "value": "UNKNOWN",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-brian-mwirigi-costhq/trust",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-brian-mwirigi-costhq/trust",
      "sourceType": "trust",
      "confidence": "medium",
      "observedAt": null,
      "isPublic": true
    }
  ],
  "events": [
    {
      "eventType": "release",
      "title": "Release 4.0.0",
      "description": "- Added Semantic Caching Proxy to intercept and cache API calls, reducing repeated costs. - Introduced granular session termination via the dashboard's Command Center. - Dashboard overview now includes Semantic Caching Proxy controls and real-time CLI execution. - Updated documentation and removed redundant skill-card.md file. - No changes to command-line usage or agent workflow.",
      "href": "https://clawhub.ai/brian-mwirigi/costhq",
      "sourceUrl": "https://clawhub.ai/brian-mwirigi/costhq",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-06-09T18:27:46.036Z",
      "isPublic": true
    }
  ]
}

Record generated Oct 10, 2026.

Sponsored

Ads related to CostHQ and adjacent AI workflows.