Skip to content

Commit 149dff6

Browse files
r17xclaude
andcommitted
chore(agent): update serena memories with universe service command
Add documentation for the new `universe service` subcommand to help future onboarding sessions understand the CLI tool capabilities. Updated memories: - project_overview: Added Universe CLI section with commands and features - codebase_structure: Added universe CLI file structure - suggested_commands: Added universe CLI usage examples Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent c125146 commit 149dff6

File tree

3 files changed

+64
-0
lines changed

3 files changed

+64
-0
lines changed

.serena/memories/codebase_structure.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -26,9 +26,14 @@
2626
│ ├── modules/ # Reusable modules
2727
│ │ ├── cross/ # Cross-platform modules
2828
│ │ ├── darwin/ # Darwin-specific modules
29+
│ │ │ └── mouseless.nix # Tiling WM setup (yabai/aerospace, skhd, sketchybar)
2930
│ │ ├── home/ # Home-manager modules
3031
│ │ ├── nixos/ # NixOS-specific modules
3132
│ │ └── flake/ # Flake-specific modules
33+
│ │ ├── universe.nix # Universe CLI tool
34+
│ │ └── universe/ # Platform-specific implementations
35+
│ │ ├── service-darwin.nix # macOS launchctl service management
36+
│ │ └── service-linux.nix # Linux systemctl service management
3237
│ │
3338
│ ├── overlays/ # Nixpkgs overlays
3439
│ │ ├── macOS packages

.serena/memories/project_overview.md

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,26 @@ A comprehensive Nix-based configuration system that manages development environm
2727
- Multiple development shells for various languages
2828
- Secret management with SOPS
2929
- Process-compose for services (Ollama, MariaDB)
30+
- **Universe CLI** - Custom management tool for identities and services
31+
32+
## Universe CLI (`universe`)
33+
A custom Nix-built CLI tool for managing the system. Located in `nix/modules/flake/universe.nix`.
34+
35+
### Commands
36+
- `universe identity` - Manage GPG identities for git (add, regen, import, remove, list, export, pubkey)
37+
- `universe rebuild` - Run darwin-rebuild switch with flake
38+
- `universe service` - Runtime service management (list, start, stop, restart, status, enable, disable, delete, logs)
39+
40+
### Service Command Details
41+
Platform-specific implementations using Nix-level OS detection (`stdenv.isDarwin`):
42+
- **macOS**: Uses `launchctl` for launchd services
43+
- **Linux**: Uses `systemctl` for systemd services
44+
45+
Features:
46+
- Short names auto-resolve (e.g., `linux-builder``org.nixos.linux-builder`)
47+
- Auto-detect system vs user domain
48+
- Default shows only nix-managed services (`org.nixos.*` / `nix-*`)
49+
- Colored terminal output with verification indicators
3050

3151
## Repository URL
3252
https://github.com/r17x/universe

.serena/memories/suggested_commands.md

Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,44 @@
11
# Suggested Commands
22

3+
## Universe CLI
4+
5+
### System Rebuild
6+
```bash
7+
universe rebuild # Run darwin-rebuild switch --flake .
8+
```
9+
10+
### Service Management
11+
```bash
12+
universe service list # List nix-managed services (default)
13+
universe service list --all # List all services (system + third-party)
14+
universe service list --running # Show only running services
15+
universe service list --user # Show user services only
16+
17+
universe service start <name> # Start a service
18+
universe service stop <name> # Stop a service
19+
universe service restart <name> # Restart a service
20+
universe service status <name> # Show detailed service status
21+
universe service enable <name> # Enable at boot
22+
universe service disable <name> # Disable at boot
23+
universe service delete <name> # Remove zombie/orphaned service
24+
universe service logs <name> # View service logs
25+
26+
# Examples:
27+
universe service restart sketchybar
28+
universe service stop linux-builder
29+
universe service status jankyborders
30+
```
31+
32+
### Identity Management (GPG/Git)
33+
```bash
34+
universe identity --list # List all identities
35+
universe identity --add <name> '<real>' <email> # Add new identity
36+
universe identity --regen <name> # Regenerate GPG key
37+
universe identity --remove <name> # Remove identity
38+
universe identity --pubkey <name|email> # Export public key
39+
universe identity --export <email> # Export secret key
40+
```
41+
342
## Darwin (macOS) System Management
443

544
### Build and Switch Configuration

0 commit comments

Comments
 (0)