new: implemented nerve uninstall command

Author: evilsocket

nerve/cli/__init__.py

@@ -7,6 +7,7 @@
 from nerve.cli.namespaces import cli as namespaces_cli
 from nerve.cli.replay import cli as replay_cli
 from nerve.cli.run import cli as run_cli
+from nerve.cli.uninstall import cli as uninstall_cli
 
 cli = typer.Typer(
     no_args_is_help=True,
@@ -20,6 +21,7 @@
 cli.add_typer(run_cli)
 cli.add_typer(replay_cli)
 cli.add_typer(namespaces_cli)
+cli.add_typer(uninstall_cli)
 
 
 @cli.command(

nerve/cli/agents.py

@@ -38,15 +38,27 @@ async def show_agents(path: pathlib.Path) -> None:
 
     if path.exists() and path.is_dir():
         print()
-        print(f"📁 {path.absolute()}")
+        print(f"📁 agents in {path.absolute()}:")
 
         for item in path.iterdir():
             if Workflow.is_workflow(item):
-                print(f"   {item.name} " + colored("<workflow>", "blue"))
+                workflow = Workflow.from_path(item)
+                print(
+                    f"     {colored(item.name, 'white', attrs=['bold'])} "
+                    + colored("<workflow>", "blue")
+                    + f" - {workflow.description}"
+                )
                 anything = True
             elif Configuration.is_agent_config(item):
-                print(f"   {item.name} " + colored("<agent>", "green"))
+                config = Configuration.from_path(item)
+                print(
+                    f"     {colored(item.name, 'white', attrs=['bold'])} "
+                    + colored("<agent>", "green")
+                    + f" - {config.description}"
+                )
                 anything = True
 
+        print()
+
     if not anything:
         print(colored(f"No agents or workflows found in {path}", "light_grey"))

nerve/cli/uninstall.py

@@ -0,0 +1,55 @@
+import pathlib
+import shutil
+import typing as t
+
+import typer
+
+import nerve
+from nerve.cli.defaults import (
+    DEFAULT_AGENTS_LOAD_PATH,
+)
+
+cli = typer.Typer(
+    no_args_is_help=True,
+    pretty_exceptions_enable=False,
+    context_settings={"help_option_names": ["-h", "--help"]},
+)
+
+
+@cli.command(
+    context_settings={"help_option_names": ["-h", "--help"]},
+    help=f"Uninstall an agent or workflow from {DEFAULT_AGENTS_LOAD_PATH}",
+)
+def uninstall(
+    name: t.Annotated[
+        str,
+        typer.Argument(help="Name of the agent or workflow to uninstall."),
+    ],
+    yes: t.Annotated[
+        bool,
+        typer.Option("--yes", "-y", help="Uninstall without asking for confirmation."),
+    ] = False,
+) -> None:
+    print(f"🧠 nerve v{nerve.__version__}")
+
+    # make sure no funny business is happening
+    if ".." in name:
+        print(f"🚨 {name} is not a valid agent or workflow name")
+        exit(1)
+
+    # get the path to the agent or workflow
+    path = pathlib.Path(DEFAULT_AGENTS_LOAD_PATH) / name
+    if not path.exists():
+        print(f"❌ {name} does not exist in {DEFAULT_AGENTS_LOAD_PATH}")
+        exit(1)
+
+    # ask for confirmation
+    if not yes:
+        typer.confirm(
+            f"⚠️  Are you sure you want to delete {name} from {DEFAULT_AGENTS_LOAD_PATH}? This action is irreversible.",
+            abort=True,
+        )
+
+    # uninstall the agent or workflow
+    shutil.rmtree(path)
+    print(f"🧠 {name} uninstalled from {DEFAULT_AGENTS_LOAD_PATH}")

nerve/models.py

@@ -108,6 +108,8 @@ class Configuration(BaseModel):
 
     # optional generator
     generator: str | None = None
+    # optional agent description
+    description: str = ""
     # optional nerve version requirement
     requires: t.Annotated[str | None, AfterValidator(_check_required_version)] = None
     # used for versioning the agents