search

name	search
description	Use when the user wants to find something across their Claude Code history — e.g. 'find where I discussed X', 'search for Y', 'when did I work on Z'
allowed-tools	["mcp__claude-view__search_sessions","mcp__claude-view__list_sessions","mcp__claude-view__get_session"]

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.

Session Search

Find sessions across the user's Claude Code history using grep-backed session search.

Steps

1. Search sessions. Call mcp__claude-view__search_sessions with the user's query as the q parameter.

2. If results are sparse, try mcp__claude-view__list_sessions with the q filter parameter and limit: 20 to catch sessions matched by metadata (project name, branch, model).

3. For the most relevant results (top 3-5), call mcp__claude-view__get_session to get full details including commits and summary.

4. Present results:

## Search Results — "[query]"

**Found:** N sessions

### Top Matches
1. **[project] / [branch]** — [date]
   [summary or relevant snippet]
   Session: [session_id] | Duration: Xm | Commits: N

2. **[project] / [branch]** — [date]
   [summary or relevant snippet]
   Session: [session_id] | Duration: Xm | Commits: N

5. If no results found, suggest alternative search terms or broader filters. Mention that search covers session summaries, commit messages, and project/branch names.

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}