Merge pull request #45 from FuzzingLabs/feature/tui-agent-setup

feat(tui): add terminal UI with hub and agent management

Author: AFredefon

USAGE.md

@@ -8,6 +8,7 @@ requires-python = ">=3.14"
 dependencies = [
     "fuzzforge-mcp==0.0.1",
     "rich>=14.0.0",
+    "textual>=1.0.0",
     "typer==0.20.1",
 ]
 

fuzzforge-cli/pyproject.toml

@@ -34,15 +34,15 @@ def main(
             envvar="FUZZFORGE_STORAGE__PATH",
             help="Path to the storage directory.",
         ),
-    ] = Path.home() / ".fuzzforge" / "storage",
+    ] = Path.cwd() / ".fuzzforge" / "storage",
     context: TyperContext = None,  # type: ignore[assignment]
 ) -> None:
     """FuzzForge AI - Security research orchestration platform.
 
     Discover and execute MCP hub tools for security research.
 
     """
-    storage = LocalStorage(storage_path=storage_path)
+    storage = LocalStorage(base_path=storage_path)
 
     context.obj = Context(
         storage=storage,
@@ -52,3 +52,19 @@ def main(
 
 application.add_typer(mcp.application)
 application.add_typer(projects.application)
+
+
+@application.command(
+    name="ui",
+    help="Launch the FuzzForge terminal interface.",
+)
+def launch_ui() -> None:
+    """Launch the interactive FuzzForge TUI dashboard.
+
+    Provides a visual dashboard showing AI agent connection status
+    and hub server availability, with wizards for setup and configuration.
+
+    """
+    from fuzzforge_cli.tui.app import FuzzForgeApp
+
+    FuzzForgeApp().run()

fuzzforge-cli/src/fuzzforge_cli/application.py

@@ -169,7 +169,7 @@ def _generate_mcp_config(
 
     # Self-contained storage paths for FuzzForge containers
     # This isolates FuzzForge from system Podman and avoids snap issues
-    fuzzforge_home = Path.home() / ".fuzzforge"
+    fuzzforge_home = Path.cwd() / ".fuzzforge"
     graphroot = fuzzforge_home / "containers" / "storage"
     runroot = fuzzforge_home / "containers" / "run"
 

fuzzforge-cli/src/fuzzforge_cli/commands/mcp.py

@@ -0,0 +1 @@
+"""FuzzForge terminal user interface."""