update defaults

Author: MarcSkovMadsen

docs/explanation/tools.md

@@ -325,15 +325,14 @@ Find relevant information:
 
 HoloViz MCP also provides a command-line interface for direct terminal use. The CLI mirrors the MCP tools above, so you can query Panel components, HoloViews elements, hvPlot plot types, and documentation from your shell.
 
-!!! tip "Short alias: `hv`"
-    Add this to your shell profile (`.bashrc`, `.zshrc`, etc.) for shorter commands:
+!!! tip "Short command: `hv`"
+    The package installs both `holoviz-mcp` and `hv` as commands. Use `hv` for shorter invocations:
 
     ```bash
-    alias hv='uvx holoviz-mcp'
+    hv search Panel Tabulator
+    hv pn get Button
     ```
 
-    Then use `hv search ...` instead of `uvx holoviz-mcp search ...`.
-
 ### Command Overview
 
 ```
@@ -382,16 +381,16 @@ All tool commands support three output formats via `-o`/`--output`:
 
 | Format | Flag | Use Case |
 |--------|------|----------|
-| `markdown` | `-o markdown` (default) | LLM-friendly, pipe to AI tools |
+| `pretty` | `-o pretty` (default) | Rich terminal rendering |
+| `markdown` | `-o markdown` | LLM-friendly, pipe to AI tools |
 | `json` | `-o json` | Scripting and automation |
-| `pretty` | `-o pretty` | Rich terminal rendering |
 
 **Examples:**
 
 ```bash
-holoviz-mcp pn get Button -o pretty     # Rich terminal output
+holoviz-mcp pn get Button               # Default pretty terminal output
 holoviz-mcp pn list -o json | jq '.[]'  # Pipe JSON to jq
-holoviz-mcp hv get Curve                 # Default markdown
+holoviz-mcp hv get Curve -o markdown     # LLM-friendly markdown
 ```
 
 ## Related Documentation

docs/how-to/configure-claude-code.md

@@ -63,13 +63,13 @@ If Claude provides detailed, accurate responses with specific Panel component in
 
 HoloViz MCP provides specialized agents for Claude Code that can help with planning and implementation:
 
-**User-level installation (default)** (installs to `~/.claude/agents/`):
+**Project-level installation (default)** (installs to `.claude/agents/`):
 
 ```bash
-holoviz-mcp install claude --scope user
+holoviz-mcp install claude
 ```
 
-**Project-level installation** (installs to `.claude/agents/`):
+**User-level installation** (installs to `~/.claude/agents/`):
 
 ```bash
 holoviz-mcp install claude --scope project

docs/tutorials/getting-started-claude-code.md

@@ -65,26 +65,26 @@ This will update your `~/.claude.json` file with the HoloViz MCP server configur
 
 HoloViz MCP includes specialized agents for Claude Code that help with planning and implementing HoloViz applications.
 
-Install the agents for your user:
+Install the agents for your project:
 
 ```bash
-holoviz-mcp install claude --scope user
+holoviz-mcp install claude
 ```
 
-This creates a `~/.claude/agents/` directory with:
+This creates a `.claude/agents/` directory with:
 
 - `holoviz-data-explorer.md` - Agent for quick data exploration and data visualization
 - `holoviz-app-architect.md` - Agent for architecting production Panel data applications
 
-!!! tip "Install Project-Level Agents"
+!!! tip "Install User-Level Agents"
 
-    To make agents available in your current project only:
+    To make agents available across all projects:
 
     ```bash
-    holoviz-mcp install claude --scope project
+    holoviz-mcp install claude --scope user
     ```
 
-    This installs agents to `.claude/agents/`.
+    This installs agents to `~/.claude/agents/`.
 
 ## Step 6: Install Panel and Dependencies (Optional)
 

docs/tutorials/getting-started-copilot-vscode.md

@@ -68,6 +68,16 @@ You should see output confirming that agents were installed to `.github/agents/`
 !!! note "What's happening"
     This command installs custom Copilot agents specifically designed for HoloViz development. These agents understand the `holoviz-mcp` server and can use it to understand the architecture patterns and best practices for Panel, hvPlot, and other HoloViz libraries.
 
+!!! tip "Install User-Level Agents"
+
+    To make agents available across all projects:
+
+    ```bash
+    holoviz-mcp install copilot --scope user
+    ```
+
+    This installs agents to `~/.copilot/agents/`.
+
 !!! tip
     Run `holoviz-mcp install copilot --skills` to populate the `.github/skills` folder too. See [Use Agent Skills in VS Code](https://code.visualstudio.com/docs/copilot/customization/agent-skills) for more info.
 

pyproject.toml

@@ -195,4 +195,5 @@ raw-options = { version_scheme = "no-guess-dev" }
 
 [project.scripts]
 "holoviz-mcp" = "holoviz_mcp.cli:cli_main"
+"hv" = "holoviz_mcp.cli:cli_main"
 "display-server" = "holoviz_mcp.display_mcp.cli:main"

src/holoviz_mcp/cli.py

@@ -2,8 +2,8 @@
 
 This module provides a unified CLI using Typer for all HoloViz MCP commands.
 
-Tool commands output Markdown by default (LLM-first). Use -o json for machine-readable
-output or -o pretty for rich terminal rendering.
+Tool commands output pretty (Rich) by default for terminal users. Use -o markdown for
+LLM-friendly output or -o json for machine-readable/scripting output.
 Infrastructure commands (serve, install, update) output human-readable text.
 """
 
@@ -73,7 +73,7 @@ class OutputFormat(str, Enum):
     pretty = "pretty"
 
 
-OutputFlag = Annotated[OutputFormat, typer.Option("--output", "-o", help="Output format: markdown (default, for LLMs), json (for scripts), pretty (rich terminal).")]
+OutputFlag = Annotated[OutputFormat, typer.Option("--output", "-o", help="Output format: pretty (default, rich terminal), markdown (for LLMs), json (for scripts).")]
 
 
 def _output_json(data: object) -> None:
@@ -161,7 +161,7 @@ def search(
     ] = "truncated",
     max_results: Annotated[int, typer.Option("--max-results", "-n", help="Maximum results.")] = 5,
     max_chars: Annotated[int, typer.Option("--max-chars", help="Max content chars per result.")] = 10000,
-    output: OutputFlag = OutputFormat.markdown,
+    output: OutputFlag = OutputFormat.pretty,
 ) -> None:
     """Search indexed documentation using semantic similarity."""
     from holoviz_mcp.core.docs import search as _search
@@ -201,7 +201,7 @@ def inspect(
     no_screenshot: Annotated[bool, typer.Option("--no-screenshot", help="Skip screenshot.")] = False,
     no_console_logs: Annotated[bool, typer.Option("--no-console-logs", help="Skip console logs.")] = False,
     log_level: Annotated[Optional[str], typer.Option("--log-level", help="Filter console logs by level.")] = None,
-    output: OutputFlag = OutputFormat.markdown,
+    output: OutputFlag = OutputFormat.pretty,
 ) -> None:
     """Inspect a web app by capturing screenshot and/or console logs."""
     from holoviz_mcp.core.inspect import inspect_app
@@ -272,7 +272,7 @@ def pn_list_cmd(
     name: Annotated[Optional[str], typer.Option("--name", "-n", help="Filter by component name.")] = None,
     module: Annotated[Optional[str], typer.Option("--module", "-m", help="Filter by module path prefix.")] = None,
     package: Annotated[Optional[str], typer.Option("--package", "-P", help="Filter by package.")] = None,
-    output: OutputFlag = OutputFormat.markdown,
+    output: OutputFlag = OutputFormat.pretty,
 ) -> None:
     """List Panel components (summary without parameter details)."""
     from holoviz_mcp.core.pn import list_components
@@ -297,7 +297,7 @@ def pn_get_cmd(
     name: Annotated[str, typer.Argument(help="Component name (e.g., 'Button').")],
     package: Annotated[Optional[str], typer.Option("--package", "-P", help="Package name.")] = None,
     module: Annotated[Optional[str], typer.Option("--module", "-m", help="Module path.")] = None,
-    output: OutputFlag = OutputFormat.markdown,
+    output: OutputFlag = OutputFormat.pretty,
 ) -> None:
     """Get full details for a single Panel component."""
     from holoviz_mcp.core.pn import get_component
@@ -325,7 +325,7 @@ def pn_params_cmd(
     name: Annotated[str, typer.Argument(help="Component name (e.g., 'Button').")],
     package: Annotated[Optional[str], typer.Option("--package", "-P", help="Package name.")] = None,
     module: Annotated[Optional[str], typer.Option("--module", "-m", help="Module path.")] = None,
-    output: OutputFlag = OutputFormat.markdown,
+    output: OutputFlag = OutputFormat.pretty,
 ) -> None:
     """Get parameter details for a single Panel component."""
     from holoviz_mcp.core.pn import get_component_parameters
@@ -355,7 +355,7 @@ def pn_search_cmd(
     query: Annotated[list[str], typer.Argument(help="Search terms (space-separated, no quotes needed).")],
     package: Annotated[Optional[str], typer.Option("--package", "-P", help="Filter by package.")] = None,
     limit: Annotated[int, typer.Option("--limit", "-l", help="Maximum results.")] = 10,
-    output: OutputFlag = OutputFormat.markdown,
+    output: OutputFlag = OutputFormat.pretty,
 ) -> None:
     """Search Panel components by keyword."""
     from holoviz_mcp.core.pn import search_components
@@ -413,7 +413,7 @@ def hv_list_cmd(output: OutputFlag = OutputFormat.markdown) -> None:
 def hv_get_cmd(
     element: Annotated[str, typer.Argument(help="Element name (e.g., 'Curve', 'Scatter').")],
     backend: Annotated[str, typer.Option("--backend", "-b", help="Plotting backend.")] = "bokeh",
-    output: OutputFlag = OutputFormat.markdown,
+    output: OutputFlag = OutputFormat.pretty,
 ) -> None:
     """Get element docstring, parameters, style and plot options."""
     from holoviz_mcp.core.hv import get_element
@@ -456,7 +456,7 @@ def hvplot_get_cmd(
     signature: Annotated[bool, typer.Option("--signature", "-s", help="Show signature instead of docstring.")] = False,
     generic: Annotated[bool, typer.Option("--generic/--no-generic", help="Include generic options shared by all plot types.")] = False,
     style: Annotated[Optional[str], typer.Option("--style", help="Backend for style options (matplotlib, bokeh, plotly).")] = None,
-    output: OutputFlag = OutputFormat.markdown,
+    output: OutputFlag = OutputFormat.pretty,
 ) -> None:
     """Get docstring or signature for an hvPlot plot type."""
     from holoviz_mcp.core.hvplot import get_plot_type
@@ -498,7 +498,7 @@ def skill_list_cmd(output: OutputFlag = OutputFormat.markdown) -> None:
 @skill_app.command("get")
 def skill_get_cmd(
     name: Annotated[str, typer.Argument(help="Skill name (e.g., 'panel', 'hvplot').")],
-    output: OutputFlag = OutputFormat.markdown,
+    output: OutputFlag = OutputFormat.pretty,
 ) -> None:
     """Get skill content (always Markdown)."""
     from holoviz_mcp.core.skills import get_skill
@@ -520,7 +520,7 @@ def skill_get_cmd(
 def doc_get_cmd(
     path: Annotated[str, typer.Argument(help="Document path (e.g., 'index.md').")],
     project: Annotated[str, typer.Argument(help="Project name (e.g., 'panel').")],
-    output: OutputFlag = OutputFormat.markdown,
+    output: OutputFlag = OutputFormat.pretty,
 ) -> None:
     """Retrieve a specific document by path and project."""
     from holoviz_mcp.core.docs import get_document
@@ -574,7 +574,7 @@ def ref_get_cmd(
     component: Annotated[str, typer.Argument(help="Component name (e.g., 'Button', 'scatter').")],
     project: Annotated[Optional[str], typer.Option("--project", "-p", help="Project name.")] = None,
     no_content: Annotated[bool, typer.Option("--no-content", help="Metadata only.")] = False,
-    output: OutputFlag = OutputFormat.markdown,
+    output: OutputFlag = OutputFormat.pretty,
 ) -> None:
     """Find reference guides for a specific component."""
     from holoviz_mcp.core.docs import get_reference_guide
@@ -626,8 +626,12 @@ def update_index(
 
 
 @install_app.command(name="copilot")
-def install_copilot(agents: bool = True, skills: bool = False) -> None:
-    """Copy HoloViz MCP resources to .github/ folders.
+def install_copilot(
+    agents: bool = True,
+    skills: bool = False,
+    scope: Annotated[str, typer.Option("--scope", help="Installation scope: 'project' for .github/, 'user' for ~/.copilot/")] = "project",
+) -> None:
+    """Install HoloViz MCP resources for GitHub Copilot.
 
     \f
 
@@ -637,6 +641,8 @@ def install_copilot(agents: bool = True, skills: bool = False) -> None:
         Install agent files.
     skills : bool, default=False
         Install skill files.
+    scope : str, default="project"
+        Installation scope: 'project' for .github/, 'user' for ~/.copilot/.
     """  # noqa: D301
     from pathlib import Path
 
@@ -650,30 +656,51 @@ def install_copilot(agents: bool = True, skills: bool = False) -> None:
 
     if agents:
         source = config.agents_dir("default", tool="copilot")
-        target = Path.cwd() / ".github" / "agents"
+
+        if scope == "user":
+            target = Path.home() / ".copilot" / "agents"
+        else:
+            target = Path.cwd() / ".github" / "agents"
+
         target.mkdir(parents=True, exist_ok=True)
 
         for file in source.glob("*.agent.md"):
-            relative_path = (target / file.name).relative_to(Path.cwd())
-            typer.echo(f"Updated: {relative_path}")
+            if scope == "user":
+                display_path = Path("~") / ".copilot" / "agents" / file.name
+            else:
+                display_path = (target / file.name).relative_to(Path.cwd())
+
+            typer.echo(f"Installed: {display_path}")
             shutil.copy(file, target / file.name)
 
     if skills:
         source = config.skills_dir("default")
-        target = Path.cwd() / ".github" / "skills"
+
+        if scope == "user":
+            target = Path.home() / ".copilot" / "skills"
+        else:
+            target = Path.cwd() / ".github" / "skills"
+
         target.mkdir(parents=True, exist_ok=True)
 
         for file in source.glob("*.md"):
-            relative_path = (target / file.name / "SKILL.md").relative_to(Path.cwd())
-            typer.echo(f"Updated: {relative_path}")
-            shutil.copy(file, target / file.name)
+            skill_dir = target / file.stem
+            skill_dir.mkdir(exist_ok=True)
+
+            if scope == "user":
+                display_path = Path("~") / ".copilot" / "skills" / file.stem / "SKILL.md"
+            else:
+                display_path = (skill_dir / "SKILL.md").relative_to(Path.cwd())
+
+            typer.echo(f"Installed: {display_path}")
+            shutil.copy(file, skill_dir / "SKILL.md")
 
 
 @install_app.command(name="claude")
 def install_claude(
     agents: bool = True,
     skills: bool = False,
-    scope: Annotated[str, typer.Option("--scope", help="Installation scope: 'project' for .claude/agents/, 'user' for ~/.claude/agents/")] = "user",
+    scope: Annotated[str, typer.Option("--scope", help="Installation scope: 'project' for .claude/agents/, 'user' for ~/.claude/agents/")] = "project",
 ) -> None:
     """Install HoloViz MCP resources for Claude Code.
 
@@ -685,7 +712,7 @@ def install_claude(
         Install agent files.
     skills : bool, default=False
         Install skill files.
-    scope : str, default="user"
+    scope : str, default="project"
         Installation scope: 'project' for .claude/agents/, 'user' for ~/.claude/agents/.
     """  # noqa: D301
     from pathlib import Path

src/holoviz_mcp/config/resources/skills/holoviews.md

@@ -528,7 +528,7 @@ Area - Area plots for stacked or filled visualizations
 ### Lookup additional information
 
 - If the HoloViz MCP server tools are available, DO use them: `search` (documentation), `hv_list` (available elements), `hv_get` (docstrings and options), `skill_get` (best-practice skills).
-- If MCP tools are not available but the `holoviz-mcp` CLI is installed (often aliased as `hv`), use the equivalent CLI commands: `holoviz-mcp search`, `holoviz-mcp hv list`, `holoviz-mcp hv get`.
+- If MCP tools are not available but the `holoviz-mcp` CLI is installed (also available as `hv`), use the equivalent CLI commands: `holoviz-mcp search`, `holoviz-mcp hv list`, `holoviz-mcp hv get`.
 - If neither is available, DO search the web. For example searching the HoloViews website for relevant information via https://holoviews.org url.
 
 ### Test the app with pytest

src/holoviz_mcp/config/resources/skills/holoviz-mcp-cli.md

@@ -18,25 +18,21 @@ The recommended way to install is as a **uv tool**:
 
     uv tool install holoviz-mcp
 
-This installs `holoviz-mcp` into an isolated environment. Since `uv tool` manages its own bin directory, users often make the CLI available under a shorter name via a shell alias or symlink:
-
-    alias hv='holoviz-mcp'              # in .bashrc / .zshrc
-
-If `hv` is on your PATH, you can substitute it in all examples below (e.g., `hv search Panel Tabulator`, `hv pn get Button`).
+This installs both `holoviz-mcp` and `hv` commands into an isolated environment. Use `hv` as a shorter alternative in all examples below (e.g., `hv search Panel Tabulator`, `hv pn get Button`).
 
 ## When to Use CLI vs MCP
 
 - **Prefer MCP tools** when the HoloViz MCP server is loaded — they return structured, typed data (including images) and integrate natively with LLM tool calling
-- **Use CLI** when MCP tools are not available but `holoviz-mcp` (or the `hv` alias) is installed and you have Bash/shell access
+- **Use CLI** when MCP tools are not available but `holoviz-mcp` (or `hv`) is installed and you have Bash/shell access
 - **Search the web** as a last resort when neither MCP tools nor CLI are available
 
 ## Output Formats
 
 All tool commands support three output formats via `--output` / `-o`:
 
-- `markdown` (default) — Markdown-formatted text, optimized for LLMs
+- `pretty` (default) — Rich terminal output with colors and tables, for humans
+- `markdown` — Markdown-formatted text, optimized for LLMs
 - `json` — Structured JSON, for scripts and programmatic use
-- `pretty` — Rich terminal output with colors and tables, for humans
 
 Setup commands (`serve`, `install`, `update`) output human-readable text by default.
 

src/holoviz_mcp/config/resources/skills/hvplot.md

@@ -218,7 +218,7 @@ area - Area plots for stacked or filled visualizations
 ### Lookup additional information
 
 - If the HoloViz MCP server tools are available, DO use them: `search` (documentation), `hvplot_list` (available plot types), `hvplot_get` (docstrings and signatures), `skill_get` (best-practice skills).
-- If MCP tools are not available but the `holoviz-mcp` CLI is installed (often aliased as `hv`), use the equivalent CLI commands: `holoviz-mcp search`, `holoviz-mcp hvplot list`, `holoviz-mcp hvplot get`.
+- If MCP tools are not available but the `holoviz-mcp` CLI is installed (also available as `hv`), use the equivalent CLI commands: `holoviz-mcp search`, `holoviz-mcp hvplot list`, `holoviz-mcp hvplot get`.
 - If neither is available, DO search the web. For example searching the hvplot website for `streaming` related information via https://hvplot.holoviz.org/en/docs/latest/search.html?q=streaming url.
 
 ### Test the app with pytest

src/holoviz_mcp/config/resources/skills/panel.md

@@ -419,7 +419,7 @@ If you experience memory issues, make sure to:
 ### Lookup additional information
 
 - If the HoloViz MCP server tools are available, DO use them to look up documentation and component details. Useful tools: `search` (documentation), `pn_search` (find components), `pn_get` (component details), `pn_params` (parameter info), `ref_get` (reference guides), `skill_get` (best-practice skills).
-- If MCP tools are not available but the `holoviz-mcp` CLI is installed (often aliased as `hv`), use the equivalent CLI commands: `holoviz-mcp search`, `holoviz-mcp pn search`, `holoviz-mcp pn get`, `holoviz-mcp pn params`, `holoviz-mcp ref get`, `holoviz-mcp skill get`.
+- If MCP tools are not available but the `holoviz-mcp` CLI is installed (also available as `hv`), use the equivalent CLI commands: `holoviz-mcp search`, `holoviz-mcp pn search`, `holoviz-mcp pn get`, `holoviz-mcp pn params`, `holoviz-mcp ref get`, `holoviz-mcp skill get`.
 - If neither is available, DO search the web. For example searching the Panel website for `Tabulator` related information via [https://panel.holoviz.org/search.html?q=Tabulator](https://panel.holoviz.org/search.html?q=Tabulator) url.
 
 ### Test the app with pytest