Quickstart

Walkthrough

1. 01

   Install a service kit

   bashCopy

   fur install nginx

   Foxora Shell intercepts the fur command, runs it in-process (no subprocess hop), and streams the standard […] → [✓] output:

   [✓] Resolved 1 package from official catalog
   [✓] Downloaded nginx 1.27.3 (2.1 MB)
   [✓] Installed in 1.4s

   Copy

   fur install nginx

2. 02

   Start the service

   bashCopy

   fur service start nginx
   fur service status nginx

   Underneath, this is systemctl on Linux, launchctl on macOS, and the Service Control Manager on Windows. The grammar above is identical regardless.

3. 03

   Tail the logs

   bashCopy

   fur logs nginx -n 20 --follow

   Output is colourised with semantic syntax (HTTP methods, status codes, paths, timestamps). Press q or Ctrl-C to stop following.

4. 04

   Open the dashboard

   bashCopy

   fur dashboard
   # or the keyboard shortcut:
   # ⌘⇧D

   A full Ratatui TUI fills the window: services pane, system pane, logs pane, installed kits pane. Press q to quit, Tab to cycle focus.

   fur dashboard

5. 05

   Ask the vixen

   Press ⌘K (or Ctrl-K) anywhere to open the vixen overlay. Type a question or a task in natural language; the vixen replies with text or a suggested command (you confirm before it runs):

   > restart all services that crashed in the last hour
   
     vixen suggests:
       fur logs --since 1h --grep 'failed' --json \
         | jq -r '.events[].service' | sort -u \
         | xargs -n1 fur service restart
   
     [⏎] run   [esc] cancel

   Copy

   No cloud round-trip required

   Vixen runs against a local Ollama by default. A remote model can be configured under fur config set vixen.remote <url>.