Project Overview

Use when the user asks about a specific project or all projects — e.g. 'show me project X', 'project overview', 'what projects do I have', 'project summary

tomevault-io Updated Sep 17, 2026

Coding & Dev Tools

Install

Press C to copy

$ npx skillmds@latest add tomevault-io/project-overview-2

Installs into ~/.claude/skills (or .claude/skills inside a project). Restart Claude Code to pick it up.

＋ Add to plugin

README badge

[![SkillMD](https://skillmd.com/badge/tomevault-io/project-overview-2.svg)](https://skillmd.com/skills/tomevault-io/project-overview-2)

Trust & safety

2 of 3 audits passed

Last audited Sep 20, 2026 · commit edb1999

Works with: Claude Code Claude.ai OpenAI Codex +

File contents

You have access to the claude-view MCP server which provides tools for monitoring, analyzing, and managing Claude Code sessions. The claude-view server must be running on localhost (it auto-starts via the plugin hook).

Important: All tool names are prefixed with mcp__claude-view__. When calling a tool, always use the full prefixed name.

Error handling: If a tool returns an error about the server not being detected, tell the user to start it with npx claude-view.

Project Overview

Show project details, sessions, branches, and contribution data.

Steps

List projects. Call mcp__claude-view__projects_list_projects to get all projects. If the user asked about a specific project, find the match.
Get project sessions. For the target project, call mcp__claude-view__projects_list_project_sessions with the project slug to get session history.
Get branches. Call mcp__claude-view__projects_list_project_branches with the project slug to see branch activity.
Get contributions. Call mcp__claude-view__contributions_get_contributions to get commit and contribution data.
Present the project dashboard:

## Project Overview — [project name]

**Path:** [project path]
**Sessions:** N total | **Branches:** M active

### Recent Sessions
- [date] — [branch] — [summary] (Xm, $X.XX)
- [date] — [branch] — [summary] (Xm, $X.XX)

### Active Branches
- `[branch]` — N sessions, last active [date]
- `[branch]` — N sessions, last active [date]

### Contributions
- Commits: N | Lines changed: +X / -Y

If showing all projects, present a summary table instead of full details:

## All Projects

| Project | Sessions | Last Active | Branches |
|---------|----------|-------------|----------|
| [name]  | N        | [date]      | M        |

Available Tools

Tool	Description
Session Tools
`list_sessions`	List sessions with filters
`get_session`	Get session details
`search_sessions`	Grep search across sessions
Stats Tools
`get_stats`	Dashboard statistics
`get_fluency_score`	AI Fluency Score (0-100)
`get_token_stats`	Token usage statistics
Live Tools
`list_live_sessions`	Currently running sessions
`get_live_summary`	Aggregate live session summary
Auth Tools
`auth_post_session`	auth session
`auth_delete_session`	auth session
`auth_get_status`	auth status
Classify Tools
`classify_start_classification`	Trigger a classification job.
`classify_cancel_classification`	Cancel a running classification job.
`classify_single_session`	Classify a single session synchronously.
`classify_get_classification_status`	Get classification status.
Claude Home Tools
`claude_home_list_claude_home`	home
Cli Tools
`cli_create_session`	- Create a new tmux-backed CLI session.
Coaching Tools
`coaching_list_rules`	- List all coaching rules from the rules directory.
`coaching_apply_rule`	- Create a new coaching rule file.
`coaching_remove_rule`	- Remove a coaching rule file.
Contributions Tools
`contributions_get_contributions`	Main contributions page data.
`contributions_get_branch_sessions`	Sessions for a branch.
`contributions_get_session_contribution`	Session contribution detail.
Devices Tools
`devices_list_devices_handler`	devices
`devices_terminate_others_handler`	others
`devices_delete_device_handler`	devices {device_id}
Export Tools
`export_sessions`	Export all sessions.
Facets Tools
`facets_facet_badges`	Quality badges (outcome + satisfaction) for the requested session IDs
`facets_trigger_facet_ingest`	Start facet ingest from the Claude Code insights cache
`facets_pattern_alert`	Check the most recent sessions for a negative satisfaction pattern
`facets_facet_stats`	Aggregate statistics across all session facets.
Health Tools
`health_config`	config
`health_check`	Health check endpoint.
`health_get_status`	Get index metadata and data freshness info.
Ide Tools
`ide_get_detect`	`GET /api/ide/detect` — return cached list of installed IDEs.
`ide_post_open`	`POST /api/ide/open` — open a file in the requested IDE.
Insights Tools
`insights_get_insights`	Compute and return behavioral insights.
`insights_get_benchmarks`	Compute personal progress benchmarks.
`insights_get_categories`	Returns hierarchical category data.
`insights_get_insights_models`	per-model usage aggregated from rollup tables.
`insights_get_insights_projects`	per-project usage aggregated from rollup tables.
`insights_get_insights_trends`	Get time-series trend data for charts.
`insights_list_invocables`	List all invocables with their usage counts.
Jobs Tools
`jobs_list_jobs`	List all active jobs.
Live Tools
`live_get_pricing`	- Return the model pricing table.
`live_dismiss_all_closed`	- Dismiss all recently closed (in-memory only).
`live_get_live_session`	- Get a single live session by ID.
`live_dismiss_session`	- Dismiss from recently closed (in-memory only).
`live_get_live_session_messages`	- Get the most recent messages for a live session.
Mcp Tools
`mcp_get_mcp_servers`	returns all deduplicated MCP server configurations.
Memory Tools
`memory_get_all_memories`	returns all memory entries grouped by scope.
`memory_get_memory_file`	read a single memory file.
`memory_get_project_memories`	returns memories for a specific project.
Monitor Tools
`monitor_snapshot`	- One-shot JSON snapshot of current resources.
Oauth Tools
`oauth_get_auth_identity`	`GET /api/oauth/identity`
`oauth_get_oauth_usage`	`GET /api/oauth/usage`
`oauth_post_oauth_usage_refresh`	`POST /api/oauth/usage/refresh`
Pairing Tools
`pairing_generate_qr`	Generate a QR payload via Supabase pair-offer.
Plans Tools
`plans_get_session_plans`	- returns plan documents for the session's slug.
Plugins Tools
`plugins_list_plugins`	- Unified view of installed + available plugins.
`plugins_list_marketplaces`	plugins marketplaces
`plugins_marketplace_action`	plugins marketplaces action
`plugins_refresh_all`	all
`plugins_refresh_status`	status
`plugins_list_ops_handler`	List all queued/running/completed ops.
`plugins_enqueue_op`	Enqueue a plugin mutation, return immediately.
Processes Tools
`processes_cleanup_processes`	processes cleanup
`processes_kill_process`	processes {pid} kill
Projects Tools
`projects_list_projects`	list all projects backed by the in-memory catalog.
`projects_list_project_branches`	List distinct branches with session counts.
`projects_list_project_sessions`	paginated sessions for one project.
Prompts Tools
`prompts_list_prompts`	List prompt history with optional search/filter.
`prompts_get_prompt_stats`	Aggregate prompt statistics.
`prompts_get_prompt_templates`	Detected prompt templates.
Providers Tools
`providers_list_providers`	providers with session counts (count > 0 only, Claude Code always first).
`providers_usage`	token/cost aggregates per foreign provider within a trailing window
Reports Tools
`reports_list_reports`	List all saved reports.
`reports_get_preview`	Aggregate preview stats for a date range.
`reports_get_report`	Get a single report.
`reports_delete_report`	Delete a report.
Sessions Tools
`sessions_get_active_sessions`	returns all active session files from ~/.claude/sessions/.
`sessions_list_branches`	Get distinct list of branch names across all sessions.
`sessions_estimate_cost`	cost estimation (Rust-only, no sidecar).
`sessions_session_activity`	Activity histogram for sparkline chart.
`sessions_session_activity_rich`	Full server-side activity aggregation.
`sessions_bulk_archive_handler`	sessions archive
`sessions_bulk_unarchive_handler`	sessions unarchive
`sessions_archive_session_handler`	sessions {id} archive
`sessions_get_file_history`	List all file changes for a session.
`sessions_get_file_diff`	history/:file_hash/diff?from=N&to=M
`sessions_get_session_hook_events`	Fetch hook events for a session.
`sessions_get_session_messages_by_id`	Get paginated messages by session ID.
`sessions_get_subagent_messages`	Paginated blocks for a sub-agent.
`sessions_unarchive_session_handler`	sessions {id} unarchive
`sessions_interact_handler`	Resolve a pending interaction (permission, question, plan, elicitation).
`sessions_get_interaction_handler`	Fetch the full interaction data for a session's pending interaction.
Settings Tools
`settings_get_claude_code_settings`	returns merged, redacted Claude Code settings.
`settings_get_settings`	Read current app settings.
`settings_update_settings`	Update app settings (partial).
`settings_update_git_sync_interval`	Update the git sync interval.
Share Tools
`share_create_share`	sessions {session_id} share
`share_revoke_share`	sessions {session_id} share
`share_list_shares`	shares
Stats Tools
`stats_ai_generation_stats`	AI generation statistics with time range filtering.
`stats_overview`	Aggregate usage statistics.
`stats_storage_stats`	Storage statistics for the settings page.
`stats_get_trends`	Get week-over-week trend metrics.
Sync Tools
`sync_indexing_status`	- lightweight JSON snapshot of indexing progress.
`sync_trigger_deep_index`	Trigger a full deep index rebuild.
`sync_trigger_git_sync`	Trigger git commit scanning (A8.5).
System Tools
`system_check_path`	Check whether a filesystem path still exists.
`system_get_system_status`	Get comprehensive system status.
`system_clear_cache`	Clear obsolete search cache.
`system_trigger_git_resync`	Trigger full git re-sync.
`system_trigger_reindex`	Trigger a full re-index.
`system_reset_all`	Factory reset all data.
Teams Tools
`teams_list_teams`	List all teams.
`teams_get_team`	Get team detail.
`teams_get_team_cost`	Get team cost breakdown.
`teams_get_team_inbox`	Get team inbox messages.
`teams_get_team_sidechains`	Get team member sidechains.
Telemetry Tools
`telemetry_set_consent`	Set telemetry consent preference.
`telemetry_ingest_event`	ingress for web journey events.
Turns Tools
`turns_get_session_turns`	- Per-turn breakdown for a historical session.
Webhooks Tools
`webhooks_list_webhooks`	list all webhooks (secrets excluded).
`webhooks_create_webhook`	create a new webhook (returns signing secret once).
`webhooks_get_webhook`	get a single webhook by ID.
`webhooks_update_webhook`	update an existing webhook (partial update).
`webhooks_delete_webhook`	remove a webhook from config and secrets.
`webhooks_test_send`	send a synthetic test payload.
Workflows Tools
`workflows_list_workflows`	workflows
`workflows_create_workflow`	workflows
`workflows_control_run`	workflows run {run_id} control
`workflows_list_workflow_runs`	workflows runs
`workflows_get_workflow_run_detail`	workflows runs {session_id} {run_id}
`workflows_get_workflow_agent_detail`	workflows runs {session_id} {run_id} agents {agent_id}
`workflows_get_workflow`	workflows {id}
`workflows_delete_workflow`	workflows {id}

Source: tombelieber/claude-view — distributed by TomeVault.

---name: project-overview-2description: Use when the user asks about a specific project or all projects — e.g. 'show me project X', 'project overview', 'what projects do I have', 'project summary---You have access to the claude-view MCP server which provides tools for monitoring, analyzing, and managing Claude Code sessions. The claude-view server must be running on localhost (it auto-starts via the plugin hook).**Important:** All tool names are prefixed with `mcp__claude-view__`. When calling a tool, always use the full prefixed name.**Error handling:** If a tool returns an error about the server not being detected, tell the user to start it with `npx claude-view`.# Project OverviewShow project details, sessions, branches, and contribution data.## Steps1. **List projects.** Call `mcp__claude-view__projects_list_projects` to get all projects. If the user asked about a specific project, find the match.2. **Get project sessions.** For the target project, call `mcp__claude-view__projects_list_project_sessions` with the project slug to get session history.3. **Get branches.** Call `mcp__claude-view__projects_list_project_branches` with the project slug to see branch activity.4. **Get contributions.** Call `mcp__claude-view__contributions_get_contributions` to get commit and contribution data.5. **Present the project dashboard:**```## Project Overview — [project name]**Path:** [project path]**Sessions:** N total | **Branches:** M active### Recent Sessions- [date] — [branch] — [summary] (Xm, $X.XX)- [date] — [branch] — [summary] (Xm, $X.XX)### Active Branches- `[branch]` — N sessions, last active [date]- `[branch]` — N sessions, last active [date]### Contributions- Commits: N | Lines changed: +X / -Y```6. **If showing all projects**, present a summary table instead of full details:```## All Projects| Project | Sessions | Last Active | Branches ||---------|----------|-------------|----------|| [name] | N | [date] | M |```## Available Tools| Tool | Description ||------|-------------|| **Session Tools** | || `list_sessions` | List sessions with filters || `get_session` | Get session details || `search_sessions` | Grep search across sessions || **Stats Tools** | || `get_stats` | Dashboard statistics || `get_fluency_score` | AI Fluency Score (0-100) || `get_token_stats` | Token usage statistics || **Live Tools** | || `list_live_sessions` | Currently running sessions || `get_live_summary` | Aggregate live session summary || **Auth Tools** | || `auth_post_session` | auth session || `auth_delete_session` | auth session || `auth_get_status` | auth status || **Classify Tools** | || `classify_start_classification` | Trigger a classification job. || `classify_cancel_classification` | Cancel a running classification job. || `classify_single_session` | Classify a single session synchronously. || `classify_get_classification_status` | Get classification status. || **Claude Home Tools** | || `claude_home_list_claude_home` | home || **Cli Tools** | || `cli_create_session` | - Create a new tmux-backed CLI session. || **Coaching Tools** | || `coaching_list_rules` | - List all coaching rules from the rules directory. || `coaching_apply_rule` | - Create a new coaching rule file. || `coaching_remove_rule` | - Remove a coaching rule file. || **Contributions Tools** | || `contributions_get_contributions` | Main contributions page data. || `contributions_get_branch_sessions` | Sessions for a branch. || `contributions_get_session_contribution` | Session contribution detail. || **Devices Tools** | || `devices_list_devices_handler` | devices || `devices_terminate_others_handler` | others || `devices_delete_device_handler` | devices {device_id} || **Export Tools** | || `export_sessions` | Export all sessions. || **Facets Tools** | || `facets_facet_badges` | Quality badges (outcome + satisfaction) for the requested session IDs || `facets_trigger_facet_ingest` | Start facet ingest from the Claude Code insights cache || `facets_pattern_alert` | Check the most recent sessions for a negative satisfaction pattern || `facets_facet_stats` | Aggregate statistics across all session facets. || **Health Tools** | || `health_config` | config || `health_check` | Health check endpoint. || `health_get_status` | Get index metadata and data freshness info. || **Ide Tools** | || `ide_get_detect` | `GET /api/ide/detect` — return cached list of installed IDEs. || `ide_post_open` | `POST /api/ide/open` — open a file in the requested IDE. || **Insights Tools** | || `insights_get_insights` | Compute and return behavioral insights. || `insights_get_benchmarks` | Compute personal progress benchmarks. || `insights_get_categories` | Returns hierarchical category data. || `insights_get_insights_models` | per-model usage aggregated from rollup tables. || `insights_get_insights_projects` | per-project usage aggregated from rollup tables. || `insights_get_insights_trends` | Get time-series trend data for charts. || `insights_list_invocables` | List all invocables with their usage counts. || **Jobs Tools** | || `jobs_list_jobs` | List all active jobs. || **Live Tools** | || `live_get_pricing` | - Return the model pricing table. || `live_dismiss_all_closed` | - Dismiss all recently closed (in-memory only). || `live_get_live_session` | - Get a single live session by ID. || `live_dismiss_session` | - Dismiss from recently closed (in-memory only). || `live_get_live_session_messages` | - Get the most recent messages for a live session. || **Mcp Tools** | || `mcp_get_mcp_servers` | returns all deduplicated MCP server configurations. || **Memory Tools** | || `memory_get_all_memories` | returns all memory entries grouped by scope. || `memory_get_memory_file` | read a single memory file. || `memory_get_project_memories` | returns memories for a specific project. || **Monitor Tools** | || `monitor_snapshot` | - One-shot JSON snapshot of current resources. || **Oauth Tools** | || `oauth_get_auth_identity` | `GET /api/oauth/identity` || `oauth_get_oauth_usage` | `GET /api/oauth/usage` || `oauth_post_oauth_usage_refresh` | `POST /api/oauth/usage/refresh` || **Pairing Tools** | || `pairing_generate_qr` | Generate a QR payload via Supabase pair-offer. || **Plans Tools** | || `plans_get_session_plans` | - returns plan documents for the session's slug. || **Plugins Tools** | || `plugins_list_plugins` | - Unified view of installed + available plugins. || `plugins_list_marketplaces` | plugins marketplaces || `plugins_marketplace_action` | plugins marketplaces action || `plugins_refresh_all` | all || `plugins_refresh_status` | status || `plugins_list_ops_handler` | List all queued/running/completed ops. || `plugins_enqueue_op` | Enqueue a plugin mutation, return immediately. || **Processes Tools** | || `processes_cleanup_processes` | processes cleanup || `processes_kill_process` | processes {pid} kill || **Projects Tools** | || `projects_list_projects` | list all projects backed by the in-memory catalog. || `projects_list_project_branches` | List distinct branches with session counts. || `projects_list_project_sessions` | paginated sessions for one project. || **Prompts Tools** | || `prompts_list_prompts` | List prompt history with optional search/filter. || `prompts_get_prompt_stats` | Aggregate prompt statistics. || `prompts_get_prompt_templates` | Detected prompt templates. || **Providers Tools** | || `providers_list_providers` | providers with session counts (count > 0 only, Claude Code always first). || `providers_usage` | token/cost aggregates per foreign provider within a trailing window || **Reports Tools** | || `reports_list_reports` | List all saved reports. || `reports_get_preview` | Aggregate preview stats for a date range. || `reports_get_report` | Get a single report. || `reports_delete_report` | Delete a report. || **Sessions Tools** | || `sessions_get_active_sessions` | returns all active session files from ~/.claude/sessions/. || `sessions_list_branches` | Get distinct list of branch names across all sessions. || `sessions_estimate_cost` | cost estimation (Rust-only, no sidecar). || `sessions_session_activity` | Activity histogram for sparkline chart. || `sessions_session_activity_rich` | Full server-side activity aggregation. || `sessions_bulk_archive_handler` | sessions archive || `sessions_bulk_unarchive_handler` | sessions unarchive || `sessions_archive_session_handler` | sessions {id} archive || `sessions_get_file_history` | List all file changes for a session. || `sessions_get_file_diff` | history/:file_hash/diff?from=N&to=M || `sessions_get_session_hook_events` | Fetch hook events for a session. || `sessions_get_session_messages_by_id` | Get paginated messages by session ID. || `sessions_get_subagent_messages` | Paginated blocks for a sub-agent. || `sessions_unarchive_session_handler` | sessions {id} unarchive || `sessions_interact_handler` | Resolve a pending interaction (permission, question, plan, elicitation). || `sessions_get_interaction_handler` | Fetch the full interaction data for a session's pending interaction. || **Settings Tools** | || `settings_get_claude_code_settings` | returns merged, redacted Claude Code settings. || `settings_get_settings` | Read current app settings. || `settings_update_settings` | Update app settings (partial). || `settings_update_git_sync_interval` | Update the git sync interval. || **Share Tools** | || `share_create_share` | sessions {session_id} share || `share_revoke_share` | sessions {session_id} share || `share_list_shares` | shares || **Stats Tools** | || `stats_ai_generation_stats` | AI generation statistics with time range filtering. || `stats_overview` | Aggregate usage statistics. || `stats_storage_stats` | Storage statistics for the settings page. || `stats_get_trends` | Get week-over-week trend metrics. || **Sync Tools** | || `sync_indexing_status` | - lightweight JSON snapshot of indexing progress. || `sync_trigger_deep_index` | Trigger a full deep index rebuild. || `sync_trigger_git_sync` | Trigger git commit scanning (A8.5). || **System Tools** | || `system_check_path` | Check whether a filesystem path still exists. || `system_get_system_status` | Get comprehensive system status. || `system_clear_cache` | Clear obsolete search cache. || `system_trigger_git_resync` | Trigger full git re-sync. || `system_trigger_reindex` | Trigger a full re-index. || `system_reset_all` | Factory reset all data. || **Teams Tools** | || `teams_list_teams` | List all teams. || `teams_get_team` | Get team detail. || `teams_get_team_cost` | Get team cost breakdown. || `teams_get_team_inbox` | Get team inbox messages. || `teams_get_team_sidechains` | Get team member sidechains. || **Telemetry Tools** | || `telemetry_set_consent` | Set telemetry consent preference. || `telemetry_ingest_event` | ingress for web journey events. || **Turns Tools** | || `turns_get_session_turns` | - Per-turn breakdown for a historical session. || **Webhooks Tools** | || `webhooks_list_webhooks` | list all webhooks (secrets excluded). || `webhooks_create_webhook` | create a new webhook (returns signing secret once). || `webhooks_get_webhook` | get a single webhook by ID. || `webhooks_update_webhook` | update an existing webhook (partial update). || `webhooks_delete_webhook` | remove a webhook from config and secrets. || `webhooks_test_send` | send a synthetic test payload. || **Workflows Tools** | || `workflows_list_workflows` | workflows || `workflows_create_workflow` | workflows || `workflows_control_run` | workflows run {run_id} control || `workflows_list_workflow_runs` | workflows runs || `workflows_get_workflow_run_detail` | workflows runs {session_id} {run_id} || `workflows_get_workflow_agent_detail` | workflows runs {session_id} {run_id} agents {agent_id} || `workflows_get_workflow` | workflows {id} || `workflows_delete_workflow` | workflows {id} |---> Source: [tombelieber/claude-view](https://github.com/tombelieber/claude-view) — distributed by [TomeVault](https://tomevault.io).

tomevault-io/skills-registry/tree/main/tombelieber--claude-view--claude-view commit edb1999633

Frequently asked questions

npx skillmds@latest add tomevault-io/project-overview-2