Dashboard

The dashboard is your primary interface for managing installed shurikens.

Overview

The dashboard displays:

• Installed shurikens - All services in ~/.ninja/shurikens/
• Runtime status - Running, stopped, or crashed state
• Quick actions - Start, stop, configure, and view logs
• Projects - Access project files and backups

Common Operations

Start/Stop Services

GUI: Click Start/Stop buttons in the dashboard

CLI:

shurikenctl start {name}
shurikenctl stop {name}
shurikenctl list  # View all statuses

View Logs

Access configured logs through the dashboard. Log paths are defined in manifest.toml:

[logs]
log-path = "logs/service.log"

Configure Services

Use the configuration editor to:

1. Edit options.toml values
2. Preview rendered configuration
3. Apply changes with the configure action

See Configuration for details.

Advanced Features

Deep Links

The GUI supports shurikenctl:// URLs for automation:

shurikenctl://start?shuriken={name}
shurikenctl://stop?shuriken={name}

Lockpick Action

⚠️ Use with caution - Removes stale lock files when a service is in an inconsistent state:

1. Stop the service: shurikenctl stop {name}
2. Verify the process is terminated: ps aux | grep {name}
3. Remove lock file if needed: rm ~/.ninja/shurikens/{name}/.ninja/shuriken.lck

Troubleshooting

Service won't start:

• Check .ninja/shuriken.lck for process information
• Review logs at the configured path
• Test the service manually

Configuration issues:

• Verify options.toml contains all required variables
• Check template syntax in config.tmpl
• Use the dashboard preview to inspect rendered output

See also: CLI Reference, Troubleshooting