---
title: "Track Your Claude Code Sessions with One Command"
description: "AI-assisted coding is the new normal, but most developers have no idea how much time they spend in Claude Code. Here is how to track it automatically."
date: "2026-02-28"
app: orma
category: "developer-productivity"
readingTime: "4 min read"
---

<p>AI-assisted coding has fundamentally changed how developers work. Claude Code, Cursor, Copilot — these tools are part of the daily workflow. But here is the problem: <strong>you cannot measure what you do not track.</strong></p>

<p>Most developers have no idea how much time they spend in AI-assisted coding sessions. Is it 30 minutes a day? Two hours? Five? Without data, you are guessing.</p>

<h2>The Claude Code Hook</h2>

<p>xeve includes a shell-based hook that integrates directly with Claude Code. It uses a heartbeat mechanism — every few minutes during an active session, it sends a signal to your xeve dashboard. When the session ends, the heartbeat stops, and xeve records the total duration.</p>

<p>Installation is one command:</p>

<p><code>curl -fsSL https://orma.xeve.io/install.sh | bash</code></p>

<p>The script installs a Claude Code hook that runs automatically whenever you start a Claude Code session. No configuration. No manual tracking. It just works.</p>

<h2>What You See in the Dashboard</h2>

<p>Once installed, your Claude Code sessions appear alongside your other coding data in the xeve dashboard. You can see:</p>

<ul>
<li><strong>Daily AI coding time</strong> — how many hours you spent in Claude Code today</li>
<li><strong>AI vs. manual coding split</strong> — what percentage of your coding is AI-assisted</li>
<li><strong>Session patterns</strong> — when during the day you use Claude Code most</li>
<li><strong>Weekly trends</strong> — is your AI usage increasing or stabilizing</li>
</ul>

<h3>Why This Matters</h3>

<p>Understanding your AI-assisted coding time helps you answer important questions:</p>

<ul>
<li>Am I actually more productive with AI tools, or just spending more time coding?</li>
<li>What types of tasks do I delegate to AI vs. do manually?</li>
<li>Is my total coding output (AI + manual) increasing over time?</li>
<li>How does AI usage correlate with my other metrics (sleep, commits, app usage)?</li>
</ul>

<p>xeve's correlation engine can find relationships between your Claude Code usage and other tracked metrics. You might discover that you use AI more on sleep-deprived days (compensating for reduced focus) or that AI-heavy days correlate with more GitHub commits.</p>

<h2>How It Works Under the Hood</h2>

<p>The hook is a lightweight shell script that sends heartbeat signals to the xeve backend. Each heartbeat includes a timestamp and session identifier. The backend aggregates these into sessions — if heartbeats stop for more than 5 minutes, the session is considered ended.</p>

<p>The data flows through the same pipeline as VS Code tracking: heartbeats are aggregated into coding sessions, which roll up into daily summaries, which feed the correlation engine and AI insights.</p>

<h2>Get Started</h2>

<p>If you use Claude Code, install the hook today. One command, zero configuration, and you will have data within your first session. Visit <a href="https://orma.xeve.io/download">xeve.io/download</a> to get the macOS app and the Claude Code hook.</p>