---
title: Claude Code Plugin
description: Install the claude-view plugin for Claude Code — auto-starts the dashboard, adds 8 tools and 3 skills. One command, zero config.
---

import { MCP_TOOL_COUNT } from '../../../../data/site';

## Overview

`@claude-view/plugin` is a **Claude Code plugin** that gives Claude native access to {MCP_TOOL_COUNT} session tools and 3 skills — no manual `settings.json` editing required.

Install with one command:

```bash
claude plugin add @claude-view/plugin
```

## What you get

### Auto-start hook

Every time you start a Claude Code session, the plugin checks if the claude-view server is running. If not, it starts it in the background. The web dashboard appears at `http://localhost:47892` — no manual `npx claude-view` needed.

### {MCP_TOOL_COUNT} MCP tools

The plugin exposes {MCP_TOOL_COUNT} read-only tools via MCP (Model Context Protocol):

| Tool | Description |
|------|-------------|
| `list_sessions` | Browse sessions with filters (project, model, date, status) |
| `get_session` | Session detail with messages, tool calls, and metrics |
| `search_sessions` | Grep search across all conversations |
| `get_stats` | Dashboard overview — total sessions, costs, trends |
| `get_fluency_score` | AI Fluency Score (0–100) with breakdown |
| `get_token_stats` | Token usage with cache hit ratio |
| `list_live_sessions` | Currently running agents (real-time) |
| `get_live_summary` | Aggregate cost and status for today |

All tools are read-only. All data stays local — no external requests.

### 3 skills

| Skill | Description |
|-------|-------------|
| `/session-recap` | Summarize a specific session — commits, metrics, duration |
| `/daily-cost` | Today's spending, running sessions, token usage |
| `/standup` | Multi-session work log for standup updates |

## Example usage

```
"How much have I spent on Claude Code today?"
→ Uses get_live_summary

"Find my last session about authentication"
→ Uses search_sessions(query: "authentication")

"What's my AI Fluency Score?"
→ Uses get_fluency_score

/session-recap
→ Summarizes your most recent session

/standup
→ Generates a standup update from the last 24h
```

## Architecture

The plugin connects to the running claude-view server on `localhost:47892`. The auto-start hook ensures the server is always running when Claude Code starts.

```
Claude Code session starts
  → Plugin SessionStart hook fires
  → Hook checks localhost:47892/api/health
    → Running? Skip.
    → Not running? Spawn: npx claude-view (background)
  → MCP server registered via plugin .mcp.json
  → Claude has 8 tools + 3 skills available
  → Web dashboard at localhost:47892
```

## Prerequisites

- **Node.js 18+** — required by the MCP server
- The plugin auto-starts the server, but `npx claude-view` must be available (downloads the Rust binary on first run)

:::note[First run]
The very first session after install may take 5–30 seconds to download the Rust binary. The hook times out gracefully — the server starts in the background and will be ready for your next tool call or session.
:::

## Configuration

Set `CLAUDE_VIEW_PORT` to override the default port (47892). Both the hook and MCP client respect this variable.
