ripperdoc 0.2.4__tar.gz → 0.2.6__tar.gz

{ripperdoc-0.2.4 → ripperdoc-0.2.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ripperdoc
-Version: 0.2.4
+Version: 0.2.6
 Summary: AI-powered terminal assistant for coding tasks
 Author: Ripperdoc Team
 License: Apache-2.0
@@ -50,6 +50,7 @@ Ripperdoc is an AI-powered terminal assistant for coding tasks, providing an int
 - **Codebase Understanding** - Analyzes project structure and code relationships
 - **Command Execution** - Run shell commands with real-time feedback
 - **Tool System** - Extensible architecture with specialized tools
+- **Agent Skills** - Load SKILL.md bundles to extend the agent on demand
 - **Subagents** - Delegate tasks to specialized agents with their own tool scopes
 - **File Operations** - Read, write, edit, search, and manage files
 - **Todo Tracking** - Plan, read, and update persistent todo lists per project
@@ -117,6 +118,16 @@ See the [examples/](examples/) directory for complete SDK usage examples.
 
 Safe mode is the default. Use `--unsafe` to skip permission prompts. Choose `a`/`always` to allow a tool for the current session (not persisted across sessions).
 
+### Agent Skills
+
+Extend Ripperdoc with reusable Skill bundles:
+
+- Personal skills live in `~/.ripperdoc/skills/<skill-name>/SKILL.md`
+- Project skills live in `.ripperdoc/skills/<skill-name>/SKILL.md` and can be checked into git
+- Each `SKILL.md` starts with YAML frontmatter (`name`, `description`, optional `allowed-tools`, `model`, `max-thinking-tokens`, `disable-model-invocation`) followed by the instructions; add supporting files alongside it
+- Model and max-thinking-token hints from skills are applied automatically for the rest of the session after you load them with the `Skill` tool
+- Ripperdoc exposes skill names/descriptions in the system prompt and loads full content on demand via the `Skill` tool
+
 ## Examples
 
 ### Code Analysis

{ripperdoc-0.2.4 → ripperdoc-0.2.6}/README.md

@@ -13,6 +13,7 @@ Ripperdoc is an AI-powered terminal assistant for coding tasks, providing an int
 - **Codebase Understanding** - Analyzes project structure and code relationships
 - **Command Execution** - Run shell commands with real-time feedback
 - **Tool System** - Extensible architecture with specialized tools
+- **Agent Skills** - Load SKILL.md bundles to extend the agent on demand
 - **Subagents** - Delegate tasks to specialized agents with their own tool scopes
 - **File Operations** - Read, write, edit, search, and manage files
 - **Todo Tracking** - Plan, read, and update persistent todo lists per project
@@ -80,6 +81,16 @@ See the [examples/](examples/) directory for complete SDK usage examples.
 
 Safe mode is the default. Use `--unsafe` to skip permission prompts. Choose `a`/`always` to allow a tool for the current session (not persisted across sessions).
 
+### Agent Skills
+
+Extend Ripperdoc with reusable Skill bundles:
+
+- Personal skills live in `~/.ripperdoc/skills/<skill-name>/SKILL.md`
+- Project skills live in `.ripperdoc/skills/<skill-name>/SKILL.md` and can be checked into git
+- Each `SKILL.md` starts with YAML frontmatter (`name`, `description`, optional `allowed-tools`, `model`, `max-thinking-tokens`, `disable-model-invocation`) followed by the instructions; add supporting files alongside it
+- Model and max-thinking-token hints from skills are applied automatically for the rest of the session after you load them with the `Skill` tool
+- Ripperdoc exposes skill names/descriptions in the system prompt and loads full content on demand via the `Skill` tool
+
 ## Examples
 
 ### Code Analysis

{ripperdoc-0.2.4 → ripperdoc-0.2.6}/ripperdoc/__init__.py

@@ -1,3 +1,3 @@
 """Ripperdoc - AI-powered coding agent."""
 
-__version__ = "0.2.4"
+__version__ = "0.2.6"

{ripperdoc-0.2.4 → ripperdoc-0.2.6}/ripperdoc/__main__.py

@@ -13,11 +13,6 @@ Features:
 Quick Start:
     pip install -e .
     ripperdoc -p "your prompt here"
-
-For more information:
-    - README.md: Project overview
-    - QUICKSTART.md: Quick start guide
-    - DEVELOPMENT.md: Development guide
 """
 
 from ripperdoc import __version__

{ripperdoc-0.2.4 → ripperdoc-0.2.6}/ripperdoc/cli/cli.py

@@ -21,6 +21,7 @@ from ripperdoc.core.config import (
 from ripperdoc.core.default_tools import get_default_tools
 from ripperdoc.core.query import query, QueryContext
 from ripperdoc.core.system_prompt import build_system_prompt
+from ripperdoc.core.skills import build_skill_summary, load_all_skills
 from ripperdoc.utils.messages import create_user_message
 from ripperdoc.utils.memory import build_memory_instructions
 from ripperdoc.core.permissions import make_permission_checker
@@ -86,18 +87,26 @@ async def run_query(
             tools = merge_tools_with_dynamic(tools, dynamic_tools)
             query_context.tools = tools
         mcp_instructions = format_mcp_instructions(servers)
-        base_system_prompt = build_system_prompt(
+        skill_result = load_all_skills(Path.cwd())
+        for err in skill_result.errors:
+            logger.warning(
+                "[skills] Failed to load skill",
+                extra={"path": str(err.path), "reason": err.reason},
+            )
+        skill_instructions = build_skill_summary(skill_result.skills)
+        additional_instructions: List[str] = []
+        if skill_instructions:
+            additional_instructions.append(skill_instructions)
+        memory_instructions = build_memory_instructions()
+        if memory_instructions:
+            additional_instructions.append(memory_instructions)
+        system_prompt = build_system_prompt(
             tools,
             prompt,
             context,
+            additional_instructions=additional_instructions or None,
             mcp_instructions=mcp_instructions,
         )
-        memory_instructions = build_memory_instructions()
-        system_prompt = (
-            f"{base_system_prompt}\n\n{memory_instructions}"
-            if memory_instructions
-            else base_system_prompt
-        )
 
         # Run the query
         try:
@@ -112,6 +121,7 @@ async def run_query(
                                 Markdown(message.message.content),
                                 title="Ripperdoc",
                                 border_style="cyan",
+                                padding=(0, 1),
                             )
                         )
                     else:
@@ -124,6 +134,7 @@ async def run_query(
                                             Markdown(block["text"]),
                                             title="Ripperdoc",
                                             border_style="cyan",
+                                            padding=(0, 1),
                                         )
                                     )
                             else:
@@ -133,6 +144,7 @@ async def run_query(
                                             Markdown(block.text or ""),
                                             title="Ripperdoc",
                                             border_style="cyan",
+                                            padding=(0, 1),
                                         )
                                     )
 
@@ -146,10 +158,14 @@ async def run_query(
 
         except KeyboardInterrupt:
             console.print("\n[yellow]Interrupted by user[/yellow]")
-        except Exception as e:
+        except asyncio.CancelledError:
+            console.print("\n[yellow]Operation cancelled[/yellow]")
+        except (RuntimeError, ValueError, TypeError, OSError, IOError, ConnectionError) as e:
             console.print(f"[red]Error: {escape(str(e))}[/red]")
-            logger.exception(
-                "[cli] Unhandled error while running prompt", extra={"session_id": session_id}
+            logger.warning(
+                "[cli] Unhandled error while running prompt: %s: %s",
+                type(e).__name__, e,
+                extra={"session_id": session_id},
             )
             if verbose:
                 import traceback
@@ -267,15 +283,15 @@ def check_onboarding() -> bool:
 @click.version_option(version=__version__)
 @click.option("--cwd", type=click.Path(exists=True), help="Working directory")
 @click.option(
-    "--unsafe",
+    "--yolo",
     is_flag=True,
-    help="Disable safe mode (skip permission prompts for tools)",
+    help="YOLO mode: skip all permission prompts for tools",
 )
 @click.option("--verbose", is_flag=True, help="Verbose output")
 @click.option("-p", "--prompt", type=str, help="Direct prompt (non-interactive)")
 @click.pass_context
 def cli(
-    ctx: click.Context, cwd: Optional[str], unsafe: bool, verbose: bool, prompt: Optional[str]
+    ctx: click.Context, cwd: Optional[str], yolo: bool, verbose: bool, prompt: Optional[str]
 ) -> None:
     """Ripperdoc - AI-powered coding agent"""
     session_id = str(uuid.uuid4())
@@ -313,7 +329,7 @@ def cli(
     # Initialize project configuration for the current working directory
     get_project_config(project_path)
 
-    safe_mode = not unsafe
+    safe_mode = not yolo
     logger.debug(
         "[cli] Configuration initialized",
         extra={"session_id": session_id, "safe_mode": safe_mode, "verbose": verbose},
@@ -374,9 +390,14 @@ def main() -> None:
     except KeyboardInterrupt:
         console.print("\n[yellow]Interrupted[/yellow]")
         sys.exit(130)
-    except Exception as e:
+    except SystemExit:
+        raise
+    except (RuntimeError, ValueError, TypeError, OSError, IOError, ConnectionError, click.ClickException) as e:
         console.print(f"[red]Fatal error: {escape(str(e))}[/red]")
-        logger.exception("[cli] Fatal error in main CLI entrypoint")
+        logger.warning(
+            "[cli] Fatal error in main CLI entrypoint: %s: %s",
+            type(e).__name__, e,
+        )
         sys.exit(1)
 
 

{ripperdoc-0.2.4 → ripperdoc-0.2.6}/ripperdoc/cli/commands/__init__.py

@@ -17,6 +17,7 @@ from .help_cmd import command as help_command
 from .memory_cmd import command as memory_command
 from .mcp_cmd import command as mcp_command
 from .models_cmd import command as models_command
+from .permissions_cmd import command as permissions_command
 from .resume_cmd import command as resume_command
 from .tasks_cmd import command as tasks_command
 from .status_cmd import command as status_command
@@ -44,6 +45,7 @@ ALL_COMMANDS: List[SlashCommand] = [
     status_command,
     doctor_command,
     memory_command,
+    permissions_command,
     tasks_command,
     todos_command,
     mcp_command,

{ripperdoc-0.2.4 → ripperdoc-0.2.6}/ripperdoc/cli/commands/agents_cmd.py

@@ -111,11 +111,12 @@ def _handle(ui: Any, trimmed_arg: str) -> bool:
             console.print(
                 f"[green]✓ Agent '{escape(agent_name)}' created at {escape(str(path))}[/green]"
             )
-        except Exception as exc:
+        except (OSError, IOError, PermissionError, ValueError) as exc:
             console.print(f"[red]Failed to create agent: {escape(str(exc))}[/red]")
             print_agents_usage()
-            logger.exception(
-                "[agents_cmd] Failed to create agent",
+            logger.warning(
+                "[agents_cmd] Failed to create agent: %s: %s",
+                type(exc).__name__, exc,
                 extra={"agent": agent_name, "session_id": getattr(ui, "session_id", None)},
             )
         return True
@@ -142,11 +143,12 @@ def _handle(ui: Any, trimmed_arg: str) -> bool:
             )
         except FileNotFoundError as exc:
             console.print(f"[yellow]{escape(str(exc))}[/yellow]")
-        except Exception as exc:
+        except (OSError, IOError, PermissionError, ValueError) as exc:
             console.print(f"[red]Failed to delete agent: {escape(str(exc))}[/red]")
             print_agents_usage()
-            logger.exception(
-                "[agents_cmd] Failed to delete agent",
+            logger.warning(
+                "[agents_cmd] Failed to delete agent: %s: %s",
+                type(exc).__name__, exc,
                 extra={"agent": agent_name, "session_id": getattr(ui, "session_id", None)},
             )
         return True
@@ -219,11 +221,12 @@ def _handle(ui: Any, trimmed_arg: str) -> bool:
             console.print(
                 f"[green]✓ Agent '{escape(agent_name)}' updated at {escape(str(path))}[/green]"
             )
-        except Exception as exc:
+        except (OSError, IOError, PermissionError, ValueError) as exc:
             console.print(f"[red]Failed to update agent: {escape(str(exc))}[/red]")
             print_agents_usage()
-            logger.exception(
-                "[agents_cmd] Failed to update agent",
+            logger.warning(
+                "[agents_cmd] Failed to update agent: %s: %s",
+                type(exc).__name__, exc,
                 extra={"agent": agent_name, "session_id": getattr(ui, "session_id", None)},
             )
         return True

{ripperdoc-0.2.4 → ripperdoc-0.2.6}/ripperdoc/cli/commands/compact_cmd.py

@@ -1,11 +1,15 @@
-import asyncio
-
 from typing import Any
 from .base import SlashCommand
 
 
 def _handle(ui: Any, trimmed_arg: str) -> bool:
-    asyncio.run(ui._run_manual_compact(trimmed_arg))
+    runner = getattr(ui, "run_async", None)
+    if callable(runner):
+        runner(ui._run_manual_compact(trimmed_arg))
+    else:
+        import asyncio
+
+        asyncio.run(ui._run_manual_compact(trimmed_arg))
     return True
 
 

{ripperdoc-0.2.4 → ripperdoc-0.2.6}/ripperdoc/cli/commands/context_cmd.py

@@ -1,4 +1,3 @@
-import asyncio
 import json
 from typing import List, Any
 
@@ -7,6 +6,7 @@ from ripperdoc.cli.ui.context_display import format_tokens
 from ripperdoc.core.config import get_global_config, provider_protocol
 from ripperdoc.core.query import QueryContext
 from ripperdoc.core.system_prompt import build_system_prompt
+from ripperdoc.core.skills import build_skill_summary, load_all_skills
 from ripperdoc.utils.memory import build_memory_instructions
 from ripperdoc.utils.message_compaction import (
     get_remaining_context_tokens,
@@ -18,7 +18,6 @@ from ripperdoc.utils.mcp import (
     estimate_mcp_tokens,
     format_mcp_instructions,
     load_mcp_servers_async,
-    shutdown_mcp_runtime,
 )
 from ripperdoc.utils.log import get_logger
 
@@ -46,21 +45,41 @@ def _handle(ui: Any, _: str) -> bool:
         )
 
     async def _load_servers() -> List[Any]:
-        try:
-            return await load_mcp_servers_async(ui.project_path)
-        finally:
-            await shutdown_mcp_runtime()
+        return await load_mcp_servers_async(ui.project_path)
 
-    servers = asyncio.run(_load_servers())
+    runner = getattr(ui, "run_async", None)
+    if callable(runner):
+        servers = runner(_load_servers())
+    else:
+        import asyncio
+
+        servers = asyncio.run(_load_servers())
     mcp_instructions = format_mcp_instructions(servers)
+    skill_result = load_all_skills(ui.project_path)
+    for err in skill_result.errors:
+        logger.warning(
+            "[skills] Failed to load skill",
+            extra={
+                "path": str(err.path),
+                "reason": err.reason,
+                "session_id": getattr(ui, "session_id", None),
+            },
+        )
+    skill_instructions = build_skill_summary(skill_result.skills)
+    additional_instructions: List[str] = []
+    if skill_instructions:
+        additional_instructions.append(skill_instructions)
+    memory_instructions = build_memory_instructions()
+    if memory_instructions:
+        additional_instructions.append(memory_instructions)
     base_system_prompt = build_system_prompt(
         ui.query_context.tools,
         "",
         {},
+        additional_instructions=additional_instructions or None,
         mcp_instructions=mcp_instructions,
     )
-    memory_instructions = build_memory_instructions()
-    memory_tokens = estimate_tokens(memory_instructions) if memory_instructions else 0
+    memory_tokens = 0
     mcp_tokens = estimate_mcp_tokens(servers) if mcp_instructions else 0
 
     breakdown = summarize_context_usage(
@@ -99,14 +118,15 @@ def _handle(ui: Any, _: str) -> bool:
                 try:
                     schema = tool.input_schema.model_json_schema()
                     token_est = estimate_tokens(json.dumps(schema, sort_keys=True))
-                except Exception:
+                except (AttributeError, TypeError, ValueError):
                     token_est = 0
                 lines.append(f"     └ {display}: {format_tokens(token_est)} tokens")
             if len(mcp_tools) > 20:
                 lines.append(f"     └ ... (+{len(mcp_tools) - 20} more)")
-    except Exception:
-        logger.exception(
-            "[context_cmd] Failed to summarize MCP tools",
+    except (OSError, RuntimeError, AttributeError, TypeError) as exc:
+        logger.warning(
+            "[context_cmd] Failed to summarize MCP tools: %s: %s",
+            type(exc).__name__, exc,
             extra={"session_id": getattr(ui, "session_id", None)},
         )
     for line in lines:

{ripperdoc-0.2.4 → ripperdoc-0.2.6}/ripperdoc/cli/commands/doctor_cmd.py

@@ -2,9 +2,9 @@
 
 from __future__ import annotations
 
-import asyncio
+import json
 from pathlib import Path
-from typing import Any, List, Optional, Tuple
+from typing import Any, Callable, List, Optional, Tuple
 
 from rich.markup import escape
 from rich.panel import Panel
@@ -18,7 +18,7 @@ from ripperdoc.core.config import (
 )
 from ripperdoc.cli.ui.helpers import get_profile_for_pointer
 from ripperdoc.utils.log import get_logger
-from ripperdoc.utils.mcp import load_mcp_servers_async, shutdown_mcp_runtime
+from ripperdoc.utils.mcp import load_mcp_servers_async
 from ripperdoc.utils.sandbox_utils import is_sandbox_available
 
 from .base import SlashCommand
@@ -108,21 +108,29 @@ def _sandbox_status() -> Tuple[str, str, str]:
     return _status_row("Sandbox", "warn", "Sandbox runtime not detected; commands run normally")
 
 
-def _mcp_status(project_path: Path) -> Tuple[List[Tuple[str, str, str]], List[str]]:
+def _mcp_status(
+    project_path: Path, runner: Optional[Callable[[Any], Any]] = None
+) -> Tuple[List[Tuple[str, str, str]], List[str]]:
     """Return MCP status rows and errors."""
     rows: List[Tuple[str, str, str]] = []
     errors: List[str] = []
 
     async def _load() -> List[Any]:
-        try:
-            return await load_mcp_servers_async(project_path)
-        finally:
-            await shutdown_mcp_runtime()
+        return await load_mcp_servers_async(project_path)
 
     try:
-        servers = asyncio.run(_load())
-    except Exception as exc:  # pragma: no cover - defensive
-        logger.exception("[doctor] Failed to load MCP servers", exc_info=exc)
+        if runner is None:
+            import asyncio
+
+            servers = asyncio.run(_load())
+        else:
+            servers = runner(_load())
+    except (OSError, RuntimeError, ConnectionError, ValueError, TypeError) as exc:  # pragma: no cover - defensive
+        logger.warning(
+            "[doctor] Failed to load MCP servers: %s: %s",
+            type(exc).__name__, exc,
+            exc_info=exc,
+        )
         rows.append(_status_row("MCP", "error", f"Failed to load MCP config: {exc}"))
         return rows, errors
 
@@ -153,8 +161,12 @@ def _project_status(project_path: Path) -> Tuple[str, str, str]:
         return _status_row(
             "Project config", "ok", f".ripperdoc/config.json loaded for {project_path}"
         )
-    except Exception as exc:  # pragma: no cover - defensive
-        logger.exception("[doctor] Failed to load project config", exc_info=exc)
+    except (OSError, IOError, json.JSONDecodeError, ValueError, TypeError) as exc:  # pragma: no cover - defensive
+        logger.warning(
+            "[doctor] Failed to load project config: %s: %s",
+            type(exc).__name__, exc,
+            exc_info=exc,
+        )
         return _status_row(
             "Project config", "warn", f"Could not read .ripperdoc/config.json: {exc}"
         )
@@ -179,7 +191,8 @@ def _handle(ui: Any, _: str) -> bool:
     project_row = _project_status(project_path)
     results.append(project_row)
 
-    mcp_rows, mcp_errors = _mcp_status(project_path)
+    runner = getattr(ui, "run_async", None)
+    mcp_rows, mcp_errors = _mcp_status(project_path, runner=runner)
     results.extend(mcp_rows)
     results.append(_sandbox_status())
 

{ripperdoc-0.2.4 → ripperdoc-0.2.6}/ripperdoc/cli/commands/exit_cmd.py

@@ -12,7 +12,7 @@ command = SlashCommand(
     name="exit",
     description="Exit Ripperdoc",
     handler=_handle,
-    aliases=("quit",),
+    aliases=(),
 )
 
 

{ripperdoc-0.2.4 → ripperdoc-0.2.6}/ripperdoc/cli/commands/mcp_cmd.py

@@ -1,21 +1,26 @@
-import asyncio
-
 from rich.markup import escape
 
-from ripperdoc.utils.mcp import load_mcp_servers_async, shutdown_mcp_runtime
+from ripperdoc.utils.mcp import load_mcp_servers_async
 
 from typing import Any
 from .base import SlashCommand
 
 
+def _run_in_ui(ui: Any, coro: Any) -> Any:
+    runner = getattr(ui, "run_async", None)
+    if callable(runner):
+        return runner(coro)
+    # Fallback for non-UI contexts.
+    import asyncio
+
+    return asyncio.run(coro)
+
+
 def _handle(ui: Any, _: str) -> bool:
     async def _load() -> list:
-        try:
-            return await load_mcp_servers_async(ui.project_path)
-        finally:
-            await shutdown_mcp_runtime()
+        return await load_mcp_servers_async(ui.project_path)
 
-    servers = asyncio.run(_load())
+    servers = _run_in_ui(ui, _load())
     if not servers:
         ui.console.print(
             "[yellow]No MCP servers configured. Add servers to ~/.ripperdoc/mcp.json, ~/.mcp.json, or a project .mcp.json file.[/yellow]"

{ripperdoc-0.2.4 → ripperdoc-0.2.6}/ripperdoc/cli/commands/memory_cmd.py

@@ -26,14 +26,14 @@ def _shorten_path(path: Path, project_path: Path) -> str:
     """Return a short, user-friendly path."""
     try:
         return str(path.resolve().relative_to(project_path.resolve()))
-    except Exception:
+    except (ValueError, OSError):
         pass
 
     home = Path.home()
     try:
         rel_home = path.resolve().relative_to(home)
         return f"~/{rel_home}"
-    except Exception:
+    except (ValueError, OSError):
         return str(path)
 
 
@@ -77,7 +77,7 @@ def _ensure_gitignore_entry(project_path: Path, entry: str) -> bool:
                 f.write("\n")
             f.write(f"{entry}\n")
         return True
-    except Exception:
+    except (OSError, IOError):
         return False
 
 
@@ -116,7 +116,7 @@ def _open_in_editor(path: Path, console: Any) -> bool:
     except FileNotFoundError:
         console.print(f"[red]Editor command not found: {escape(editor_cmd[0])}[/red]")
         return False
-    except Exception as exc:  # pragma: no cover - best-effort logging
+    except (OSError, subprocess.SubprocessError) as exc:  # pragma: no cover - best-effort logging
         console.print(f"[red]Failed to launch editor: {escape(str(exc))}[/red]")
         return False
 
@@ -195,7 +195,7 @@ command = SlashCommand(
     name="memory",
     description="List and edit AGENTS memory files",
     handler=_handle,
-    aliases=("mem",),
+    aliases=(),
 )
 
 

{ripperdoc-0.2.4 → ripperdoc-0.2.6}/ripperdoc/cli/commands/models_cmd.py

@@ -35,6 +35,7 @@ def _handle(ui: Any, trimmed_arg: str) -> bool:
         console.print("[bold]/models edit <name>[/bold] — edit an existing model profile")
         console.print("[bold]/models delete <name>[/bold] — delete a model profile")
         console.print("[bold]/models use <name>[/bold] — set the main model pointer")
+        console.print("[bold]/models use <pointer> <name>[/bold] — set a specific pointer (main/task/reasoning/quick)")
 
     def parse_int(prompt_text: str, default_value: Optional[int]) -> Optional[int]:
         raw = console.input(prompt_text).strip()
@@ -181,10 +182,11 @@ def _handle(ui: Any, trimmed_arg: str) -> bool:
                 overwrite=overwrite,
                 set_as_main=set_as_main,
             )
-        except Exception as exc:
+        except (OSError, IOError, ValueError, TypeError, PermissionError) as exc:
             console.print(f"[red]Failed to save model: {escape(str(exc))}[/red]")
-            logger.exception(
-                "[models_cmd] Failed to save model profile",
+            logger.warning(
+                "[models_cmd] Failed to save model profile: %s: %s",
+                type(exc).__name__, exc,
                 extra={"profile": profile_name, "session_id": getattr(ui, "session_id", None)},
             )
             return True
@@ -289,10 +291,11 @@ def _handle(ui: Any, trimmed_arg: str) -> bool:
                 overwrite=True,
                 set_as_main=False,
             )
-        except Exception as exc:
+        except (OSError, IOError, ValueError, TypeError, PermissionError) as exc:
             console.print(f"[red]Failed to update model: {escape(str(exc))}[/red]")
-            logger.exception(
-                "[models_cmd] Failed to update model profile",
+            logger.warning(
+                "[models_cmd] Failed to update model profile: %s: %s",
+                type(exc).__name__, exc,
                 extra={"profile": profile_name, "session_id": getattr(ui, "session_id", None)},
             )
             return True
@@ -311,30 +314,58 @@ def _handle(ui: Any, trimmed_arg: str) -> bool:
             console.print(f"[green]✓ Deleted model '{escape(target)}'[/green]")
         except KeyError as exc:
             console.print(f"[yellow]{escape(str(exc))}[/yellow]")
-        except Exception as exc:
+        except (OSError, IOError, PermissionError) as exc:
             console.print(f"[red]Failed to delete model: {escape(str(exc))}[/red]")
             print_models_usage()
-            logger.exception(
-                "[models_cmd] Failed to delete model profile",
+            logger.warning(
+                "[models_cmd] Failed to delete model profile: %s: %s",
+                type(exc).__name__, exc,
                 extra={"profile": target, "session_id": getattr(ui, "session_id", None)},
             )
         return True
 
     if subcmd in ("use", "main", "set-main"):
-        target = tokens[1] if len(tokens) > 1 else console.input("Model to use as main: ").strip()
+        # Support both "/models use <profile>" and "/models use <pointer> <profile>"
+        valid_pointers = {"main", "task", "reasoning", "quick"}
+
+        if len(tokens) >= 3:
+            # /models use <pointer> <profile>
+            pointer = tokens[1].lower()
+            target = tokens[2]
+            if pointer not in valid_pointers:
+                console.print(f"[red]Invalid pointer '{escape(pointer)}'. Valid pointers: {', '.join(valid_pointers)}[/red]")
+                print_models_usage()
+                return True
+        elif len(tokens) >= 2:
+            # Check if second token is a pointer or a profile
+            if tokens[1].lower() in valid_pointers:
+                pointer = tokens[1].lower()
+                target = console.input(f"Model to use for '{pointer}': ").strip()
+            else:
+                # /models use <profile> (defaults to main)
+                pointer = "main"
+                target = tokens[1]
+        else:
+            pointer = console.input("Pointer (main/task/reasoning/quick) [main]: ").strip().lower() or "main"
+            if pointer not in valid_pointers:
+                console.print(f"[red]Invalid pointer '{escape(pointer)}'. Valid pointers: {', '.join(valid_pointers)}[/red]")
+                return True
+            target = console.input(f"Model to use for '{pointer}': ").strip()
+
         if not target:
             console.print("[red]Model name is required.[/red]")
             print_models_usage()
             return True
         try:
-            set_model_pointer("main", target)
-            console.print(f"[green]✓ Main model set to '{escape(target)}'[/green]")
-        except Exception as exc:
+            set_model_pointer(pointer, target)
+            console.print(f"[green]✓ Pointer '{escape(pointer)}' set to '{escape(target)}'[/green]")
+        except (ValueError, KeyError, OSError, IOError, PermissionError) as exc:
             console.print(f"[red]{escape(str(exc))}[/red]")
             print_models_usage()
-            logger.exception(
-                "[models_cmd] Failed to set main model pointer",
-                extra={"profile": target, "session_id": getattr(ui, "session_id", None)},
+            logger.warning(
+                "[models_cmd] Failed to set model pointer: %s: %s",
+                type(exc).__name__, exc,
+                extra={"pointer": pointer, "profile": target, "session_id": getattr(ui, "session_id", None)},
             )
         return True