@nemus-cli/nemus 0.2.4 → 0.2.6

package/skills/list-org-repos.md

@@ -3,12 +3,6 @@ name: list-org-repos
 description: List all organization repositories from GitHub
 ---
 
-# List Org Repos
-
-List all repositories in the GitHub organization.
-
-## Running
-
 ```bash
 nemus cache list
 ```
@@ -17,10 +11,3 @@ If the cache is empty or stale:
 ```bash
 nemus cache refresh
 ```
-
-## Presenting Results
-
-Show repo names. Can be filtered by searching:
-```bash
-nemus cache search <keyword>
-```

package/skills/list-suites.md

@@ -3,20 +3,10 @@ name: list-suites
 description: List all saved suites (reusable repo collections)
 ---
 
-# List Suites
-
-List all saved suites (reusable collections of repos).
-
-## Running
-
 ```bash
 nemus suite list
 ```
 
-## Presenting Results
-
-Show each suite's name and the repos it contains.
-
 ## Related
 
 - `nemus suite create` to create a new suite

package/skills/list-workspaces.md

@@ -3,12 +3,6 @@ name: list-workspaces
 description: List all workspaces with their repo counts and creation dates
 ---
 
-# List Workspaces
-
-List all workspaces with their status.
-
-## Listing
-
 ```bash
 nemus list
 ```
@@ -17,11 +11,3 @@ Note: This command opens an interactive picker. To just see the output without s
 ```bash
 nemus list 2>&1 | cat
 ```
-
-## Presenting Results
-
-Show each workspace with:
-- Name
-- Number of repositories
-- Creation date
-- Last active session (if any)

package/skills/nemus/SKILL.md

@@ -0,0 +1,110 @@
+---
+name: nemus
+description: Manage multi-repo development workspaces — create, sync, branch, diff, clone, archive, analyze dependencies, run commands across repos, check status, clean up, delete, list org repos, search repos, list suites, remove repo, cache, suite management, sessions, history, generate docs, configure, MCP server, AI prompt. Use when working with workspaces, repos, branches, git operations across multiple repos, or the `nemus` CLI tool. NEVER use `git clone` directly — always use `nemus update` to add repos and `nemus create` to create workspaces.
+bashPattern: "\\bnemus\\s+(create|list|update|delete|sync|status|diff|run|go|doctor|analyze-deps|history|cleanup|remove-repo|archive|sessions|generate-docs|configure|configure-claude|ghq-status|tui|dashboard|dash|branch|suite|cache|mcp|--)\\b"
+---
+
+# Nemus
+
+Manage multi-repo workspaces with the `nemus` CLI (alias `nem`). Every command has `--help`.
+
+> **Rules — do not break these:**
+> - **Never** `git clone` to add a repo or create a workspace — use `nemus create` / `nemus update`. Direct git bypasses workspace metadata and breaks `nemus status`/`sync`.
+> - **Never** `git worktree` for a second checkout — worktrees are invisible to `nemus`. Add another instance with `nemus update --repos <repo>:<suffix>` (clones into `<repo>-<suffix>`, tracked independently).
+> - **Only read code from repos in the CURRENT workspace.** Need another repo? Add it with `nemus update --repos <repo>` and read it here — never read from another workspace or a global clone path (they may be stale/on other branches).
+
+## Usage
+
+Commands are options-first with an interactive fallback: pass flags to run non-interactively; omit them (with a TTY) to be prompted. `--yes`/`-y` skips confirmations and the post-create agent launch.
+
+```bash
+nemus create --workspace payments --repos partnerships-api,payments-db --yes   # non-interactive
+nemus create                                                                    # fully interactive
+```
+
+Global flags: `-f/--force-refresh` (skip repo cache), `-y/--yes` (skip prompts), `-V/--version`, `-h/--help`.
+
+## Command Reference
+
+### Core Workspace Lifecycle
+
+| Intent | Reference | CLI | Alias |
+|---|---|---|---|
+| Create new workspace | [create-workspace](references/create-workspace.md) | `nemus create` | `c` |
+| Add repos to workspace | [update-workspace](references/update-workspace.md) | `nemus update` | `u` |
+| Delete workspace permanently | [delete-workspace](references/delete-workspace.md) | `nemus delete` | `d` |
+| Archive / unarchive workspace | [archive-workspace](references/archive-workspace.md) | `nemus archive` | `a` |
+| List all workspaces | [list-workspaces](references/list-workspaces.md) | `nemus list` | `l` |
+| Navigate to workspace | [go](references/go.md) | `nemus go [name]` | — |
+
+### Status & Operations
+
+| Intent | Reference | CLI | Alias |
+|---|---|---|---|
+| Git status across repos | [workspace-status](references/workspace-status.md) | `nemus status [name]` | `st` |
+| Pull latest (git sync) | [workspace-sync](references/workspace-sync.md) | `nemus sync [name]` | `s` |
+| Show diff summary | [workspace-diff](references/workspace-diff.md) | `nemus diff [name]` | `di` |
+| Run shell command across repos | [run-command](references/run-command.md) | `nemus run [name] <cmd>` | `r` |
+| Health check | [workspace-doctor](references/workspace-doctor.md) | `nemus doctor [name]` | `doc` |
+| Clean node_modules / artifacts | [workspace-cleanup](references/workspace-cleanup.md) | `nemus cleanup <name>` | `cl` |
+| Remove repo from workspace | [remove-repo](references/remove-repo.md) | `nemus remove-repo` | `rr` |
+| Analyze inter-repo deps | [analyze-deps](references/analyze-deps.md) | `nemus analyze-deps [name]` | `ad` |
+| Generate docs for workspace | [generate-docs](references/generate-docs.md) | `nemus generate-docs [name]` | `gd` |
+
+### Branch Management
+
+| Intent | Reference | CLI |
+|---|---|---|
+| Switch branch across repos | [switch-branch](references/switch-branch.md) | `nemus branch switch` |
+| Create branch across repos | [branch-create](references/branch-create.md) | `nemus branch create` |
+| Merge branches across repos | [branch-merge](references/branch-merge.md) | `nemus branch merge <ws> <src> <tgt>` |
+| Rebase branches across repos | [branch-rebase](references/branch-rebase.md) | `nemus branch rebase <ws> <base>` |
+
+### Suites (Reusable Repo Collections)
+
+| Intent | Reference | CLI |
+|---|---|---|
+| List saved suites | [list-suites](references/list-suites.md) | `nemus suite list` |
+| Create a suite | [suite-create](references/suite-create.md) | `nemus suite create` |
+| Delete a suite | [suite-delete](references/suite-delete.md) | `nemus suite delete` |
+| Export suite(s) to JSON | [suite-export](references/suite-export.md) | `nemus suite export [file]` |
+| Import suite(s) from JSON | [suite-import](references/suite-import.md) | `nemus suite import <file>` |
+| Create workspace from suite | [suite-use](references/suite-use.md) | `nemus suite use` |
+
+### Cache & Repo Discovery
+
+| Intent | Reference | CLI |
+|---|---|---|
+| Search org repos | [search-repos](references/search-repos.md) | `nemus cache search <query>` |
+| List all org repos | [list-org-repos](references/list-org-repos.md) | `nemus cache list` |
+| View cache statistics | [cache-info](references/cache-info.md) | `nemus cache info` |
+| Refresh repo cache | [update-cache](references/update-cache.md) | `nemus cache refresh` |
+| Clear cache | [cache-clear](references/cache-clear.md) | `nemus cache clear` |
+
+### Sessions & History
+
+| Intent | Reference | CLI | Alias |
+|---|---|---|---|
+| Resume Claude session | [sessions](references/sessions.md) | `nemus sessions` | `ses` |
+| Agent management dashboard | [dashboard](references/dashboard.md) | `nemus dashboard` | `dash` |
+| View operation history | [history](references/history.md) | `nemus history` | `h` |
+
+### Configuration & MCP
+
+| Intent | Reference | CLI |
+|---|---|---|
+| Configure Nemus | [configure](references/configure.md) | `nemus configure` |
+| Configure Claude integration | [configure-claude](references/configure-claude.md) | `nemus configure-claude` |
+| Check ghq status | [ghq-status](references/ghq-status.md) | `nemus ghq-status` |
+| Install / manage MCP server | [mcp](references/mcp.md) | `nemus mcp install\|status\|upgrade\|uninstall` |
+
+### AI Assistant & TUI
+
+| Intent | Reference | CLI |
+|---|---|---|
+| Natural-language workspace management | [ai-prompt](references/ai-prompt.md) | `nemus -- <prompt>` |
+| Full interactive terminal UI | — | `nemus tui` |
+
+## Routing
+
+Match the user's intent to a row above and read that reference before running commands. If no reference exists, use `nemus <command> --help`. All repo management must go through `nemus` so metadata and context files stay in sync.

package/skills/{workspace-manager → nemus}/references/ai-prompt.md

@@ -1,9 +1,5 @@
 # AI Prompt
 
-Use natural language to manage workspaces via Claude Code with MCP tools.
-
-## Instructions
-
 ```bash
 nemus -- <prompt>
 ```
@@ -20,24 +16,14 @@ nemus -- "Show me the status of my platform workspace"
 nemus -- "Set up a workspace for the billing migration"
 ```
 
-## How It Works
-
 1. Launches Claude Code CLI with a system prompt describing all available MCP tools
 2. Claude interprets the natural language request
 3. Claude uses MCP tools (create-workspace, search-repos, etc.) to fulfill the request
 4. Results are presented conversationally
 
-## Prerequisites
-
 - Claude Code CLI must be installed (`claude` command available)
 - MCP server should be installed (`nemus mcp install`)
 
-## When to Suggest
-
-- User wants to manage workspaces conversationally
-- User describes a complex workspace setup in natural language
-- User is new to the CLI and prefers natural language
-
 ## Notes
 
 - The shell integration treats `nemus --` as a create-like command — if a workspace is created, it auto-CDs into it.

package/skills/{workspace-manager → nemus}/references/analyze-deps.md

@@ -1,9 +1,5 @@
 # Analyze Dependencies
 
-Analyze inter-repository dependencies within a workspace and detect circular dependencies.
-
-## Instructions
-
 ```bash
 nemus analyze-deps <workspace>
 ```
@@ -18,8 +14,6 @@ Without a workspace name, prompts interactively:
 nemus analyze-deps
 ```
 
-## What It Analyzes
-
 - `package.json` dependencies (npm packages that match workspace repo names)
 - `Dockerfile` references
 - `docker-compose.yml` service references
@@ -31,15 +25,3 @@ nemus analyze-deps
 - **Missing dependencies** — repos referenced but not in the workspace
 - **Mermaid diagram** — visual dependency graph
 - Optionally saves analysis to workspace metadata
-
-## Suggested Follow-ups
-
-- Missing dependencies: `nemus update --workspace <name> --repos <missing>` to add them
-- Circular dependencies: explain resolution strategies
-- For documentation: `nemus generate-docs <name>` to include the dependency graph
-
-## Success Criteria
-
-- Dependency analysis is presented with per-repo dependency lists.
-- Circular dependencies are highlighted if detected.
-- Missing repos are identified.

package/skills/nemus/references/archive-workspace.md

@@ -0,0 +1,22 @@
+# Archive Workspace
+
+```bash
+nemus archive --workspace <name> --yes
+```
+
+```bash
+nemus archive --unarchive --workspace <name> --yes
+```
+
+To list archived workspaces first:
+```bash
+nemus list --archived
+```
+
+## Flags
+
+| Flag | Short | Description |
+|---|---|---|
+| `--workspace <name>` | `-w` | Workspace name(s), comma-separated for multiple |
+| `--yes` | `-y` | Skip confirmation prompt |
+| `--unarchive` | | Restore instead of archive |

package/skills/{workspace-manager → nemus}/references/branch-create.md

@@ -1,9 +1,5 @@
 # Branch Create
 
-Create a new branch across all repositories in a workspace.
-
-## Instructions
-
 ```bash
 nemus branch create --workspace <name> --branch <branch-name>
 nemus branch create --workspace <name> --branch <branch-name> --base <base-branch>
@@ -25,7 +21,3 @@ nemus branch create <workspace> <branch-name> --base <base-branch> --force
 | `--force` | | Force create even if branch exists |
 
 After creation, run `nemus status <name>` to verify all repos are on the new branch.
-
-## Success Criteria
-
-- New branch is created in all repos and per-repo results are reported.

package/skills/{workspace-manager → nemus}/references/branch-merge.md

@@ -1,9 +1,5 @@
 # Branch Merge
 
-Merge a source branch into a target branch across all repositories in a workspace.
-
-## Instructions
-
 1. Run:
    ```bash
    nemus branch merge <workspace> <source-branch> <target-branch> [--no-ff|--ff-only|--squash]
@@ -15,8 +11,3 @@ Merge a source branch into a target branch across all repositories in a workspac
    - Summary count
 
 3. If there are merge conflicts, suggest the user resolve them manually in the affected repos.
-
-## Success Criteria
-
-- Merge is attempted in all repos.
-- Results are reported per repo with success/failure status.

package/skills/{workspace-manager → nemus}/references/branch-rebase.md

@@ -1,9 +1,5 @@
 # Branch Rebase
 
-Rebase all repositories in a workspace onto a target branch.
-
-## Instructions
-
 1. Run:
    ```bash
    nemus branch rebase <workspace> <target-branch>
@@ -15,8 +11,3 @@ Rebase all repositories in a workspace onto a target branch.
    - Summary count
 
 3. If there are rebase conflicts, suggest the user resolve them manually in the affected repos.
-
-## Success Criteria
-
-- Rebase is attempted in all repos.
-- Results are reported per repo with success/failure status.

package/skills/{workspace-manager → nemus}/references/cache-clear.md

@@ -1,9 +1,5 @@
 # Cache Clear
 
-Clear the local GitHub repository cache. A new cache will be created automatically on next fetch.
-
-## Instructions
-
 1. Run:
    ```bash
    nemus cache clear
@@ -12,7 +8,3 @@ Clear the local GitHub repository cache. A new cache will be created automatical
 2. Confirm the cache was cleared.
 
 3. Suggest `nemus cache refresh` if the user wants to immediately rebuild the cache.
-
-## Success Criteria
-
-- Cache is cleared successfully.

package/skills/{workspace-manager → nemus}/references/cache-info.md

@@ -1,9 +1,5 @@
 # Cache Info
 
-View cache statistics including repo count, age, and size.
-
-## Instructions
-
 1. Run:
    ```bash
    nemus cache info
@@ -16,7 +12,3 @@ View cache statistics including repo count, age, and size.
    - Cache size
 
 3. If cache is stale or missing, suggest `nemus cache refresh`.
-
-## Success Criteria
-
-- Cache statistics are displayed.

package/skills/{workspace-manager → nemus}/references/configure-claude.md

@@ -1,9 +1,5 @@
 # Configure Claude
 
-Configure Claude Code integration settings.
-
-## Instructions
-
 ```bash
 nemus configure-claude
 ```
@@ -25,7 +21,3 @@ w cc
 - This is interactive-only — there are no non-interactive flags.
 - The `.claude.md` file provides workspace context to Claude Code sessions.
 - Auto-launch requires the Claude Code CLI to be installed.
-
-## Success Criteria
-
-- Claude integration settings are updated.

package/skills/{workspace-manager → nemus}/references/configure.md

@@ -1,9 +1,5 @@
 # Configure
 
-Configure workspace-manager global settings interactively.
-
-## Instructions
-
 ```bash
 nemus configure
 ```
@@ -29,7 +25,3 @@ w cfg
 - Changing the GitHub org clears the repo cache automatically.
 - Enabling MCP after disabling it triggers an automatic install.
 - This is interactive-only — there are no non-interactive flags.
-
-## Success Criteria
-
-- User's settings are saved to `~/.nemus/config.json`.

package/skills/{workspace-manager → nemus}/references/create-workspace.md

@@ -1,9 +1,5 @@
 # Create Workspace
 
-Create a new workspace with specified repositories.
-
-## Instructions
-
 1. If the user hasn't specified which repos they want, help them discover repos:
    - Run `nemus cache search <query>` to search by name or description.
    - Run `nemus cache list` to browse all available repos.
@@ -38,8 +34,3 @@ Create a new workspace with specified repositories.
 nemus create --workspace payments --repos partnerships-api,payments-db --yes
 nemus suite use --suite platform --workspace platform-ws --yes
 ```
-
-## Success Criteria
-
-- Workspace directory exists with all requested repos cloned.
-- User is informed of the workspace path and suggested next steps.

package/skills/{workspace-manager → nemus}/references/dashboard.md

@@ -1,9 +1,5 @@
 # Dashboard
 
-Launch a tmux-based multi-agent management dashboard for monitoring and controlling Claude agents across workspaces.
-
-## Instructions
-
 ```bash
 nemus dashboard
 nemus dash
@@ -36,26 +32,15 @@ Opens a tmux session with a sidebar showing active agents and their status. Agen
 | `q` | Detach — agents keep running in background |
 | `Q` | Quit all — kills session and all agents |
 
-## From any agent pane
-
 | Key | Action |
 |---|---|
 | `prefix+M` | Return to sidebar / reset layout |
 
-## Prerequisites
-
 - `tmux` must be installed (`brew install tmux`)
 - Claude CLI must be available for agent launching
 
-## Features
-
 - Real-time agent status via Claude Code hooks (idle/working/waiting/stopped)
 - Session persistence: `q` detaches, `nemus dash` reconnects
 - Zoom mode: selected agent takes full right side, others hidden
 - Session resume picker (`s`) with fuzzy search
 - Auto-installs Claude hooks on first run
-
-## Success Criteria
-
-- Tmux dashboard opens with sidebar and agent panes.
-- Agents can be launched, monitored, focused, zoomed, and killed from the dashboard.

package/skills/{workspace-manager → nemus}/references/delete-workspace.md

@@ -1,9 +1,5 @@
 # Delete Workspace
 
-Permanently delete one or more workspaces and all their cloned repositories.
-
-## Instructions
-
 1. **Confirm with the user before deleting.** This is a destructive, irreversible operation.
 
 2. Warn the user about any uncommitted changes — run `nemus status <name>` to check first.
@@ -26,8 +22,3 @@ Permanently delete one or more workspaces and all their cloned repositories.
 |---|---|---|
 | `--workspace <name>` | `-w` | Workspace name(s), comma-separated for multiple |
 | `--yes` | `-y` | Skip confirmation prompt |
-
-## Success Criteria
-
-- Workspace directory and all cloned repos are removed from disk.
-- User received explicit confirmation before deletion (unless `--yes` was passed).

package/skills/{workspace-manager → nemus}/references/generate-docs.md

@@ -1,9 +1,5 @@
 # Generate Docs
 
-Generate workspace documentation including a README, dependency graph, and repository index.
-
-## Instructions
-
 ```bash
 nemus generate-docs <workspace>
 ```
@@ -18,19 +14,7 @@ Without a workspace name, prompts interactively:
 nemus generate-docs
 ```
 
-## Generated Files
-
 Creates these files in the workspace root:
 - `WORKSPACE-README.md` — Overview of the workspace and its repos
 - `DEPENDENCY-GRAPH.md` — Mermaid diagram of inter-repo dependencies
 - `REPOSITORY-INDEX.md` — Detailed index of all repos
-
-## When to Suggest
-
-- After creating a workspace with many repos
-- When user wants to understand workspace structure
-- When onboarding someone to a multi-repo project
-
-## Success Criteria
-
-- All three documentation files are generated in the workspace directory.

package/skills/{workspace-manager → nemus}/references/ghq-status.md

@@ -1,28 +1,14 @@
 # GHQ Status
 
-Check the status of ghq integration for faster repository cloning.
-
-## Instructions
-
 ```bash
 nemus ghq-status
 ```
 
-## What It Shows
-
 - Whether ghq is installed
 - ghq root directory and number of managed repos
 - How ghq accelerates workspace creation (cached local copies)
 
-## How ghq Works with Workspace Manager
-
 1. **First clone**: ghq downloads repo to its cache
 2. **Workspace creation**: Copies from ghq cache instead of cloning from remote
 3. **Subsequent clones**: Much faster (local copy vs network clone)
 4. **Isolation**: Each workspace still gets its own independent clone
-
-## When to Suggest
-
-- User reports slow workspace creation
-- User asks about optimizing clone performance
-- User asks what ghq is or whether to install it

package/skills/{workspace-manager → nemus}/references/go.md

@@ -1,9 +1,5 @@
 # Go (Navigate to Workspace)
 
-Quickly navigate to a workspace directory. Works with the `nemgo` shell function for auto-CD.
-
-## Instructions
-
 With a known workspace name:
 ```bash
 nemus go <name>
@@ -21,13 +17,6 @@ nemgo <name>
 
 The `nemgo` variant also launches Claude Code automatically if a session exists.
 
-## How It Works
-
 1. `nemus go` writes the workspace path to `~/.workspace-last-go`
 2. The shell integration function reads that file and runs `cd`
 3. If the workspace has an existing Claude session, it resumes it
-
-## Success Criteria
-
-- The terminal's working directory changes to the workspace path.
-- If a Claude session exists, it resumes automatically (with `nemgo`).

package/skills/{workspace-manager → nemus}/references/history.md

@@ -1,11 +1,5 @@
 # History
 
-View operation history for workspace-manager commands.
-
-## Instructions
-
-### Show Recent History
-
 ```bash
 nemus history
 nemus history show 50           # last 50 records
@@ -13,29 +7,18 @@ nemus history show --command create   # filter by command
 nemus history show --workspace my-ws  # filter by workspace
 ```
 
-### Show Statistics
-
 ```bash
 nemus history stats
 ```
 
 Shows total operations, success rate, average duration, and per-command usage counts.
 
-### Clear History
-
 ```bash
 nemus history clear
 nemus history clear --yes    # skip confirmation
 ```
 
-## Alias
-
 ```bash
 w h              # same as nemus history
 w h stats        # same as nemus history stats
 ```
-
-## Success Criteria
-
-- History records are displayed in a table with timestamp, command, workspace, duration, and status.
-- Stats show meaningful aggregations.

package/skills/{workspace-manager → nemus}/references/list-org-repos.md

@@ -1,9 +1,5 @@
 # List Org Repos
 
-List all organization repositories from GitHub.
-
-## Instructions
-
 1. Run:
    ```bash
    nemus cache list
@@ -19,8 +15,3 @@ List all organization repositories from GitHub.
    - Asking the user to narrow down with `nemus cache search <query>` if needed
 
 3. If the cache is stale, suggest `nemus cache refresh` to update it.
-
-## Success Criteria
-
-- All org repos are listed, optionally grouped by prefix.
-- User is guided toward `nemus cache search` if the list is too large to browse.

package/skills/{workspace-manager → nemus}/references/list-suites.md

@@ -1,9 +1,5 @@
 # List Suites
 
-List all saved suites with their repo counts.
-
-## Instructions
-
 ```bash
 nemus suite list
 ```
@@ -14,8 +10,3 @@ To create a workspace from a suite (non-interactive):
 ```bash
 nemus suite use --suite <suite-name> --workspace <workspace-name> --yes
 ```
-
-## Success Criteria
-
-- All available suites are listed with their repo counts and descriptions.
-- User is guided toward `nemus suite use` if they want to create a workspace from a suite.

package/skills/{workspace-manager → nemus}/references/list-workspaces.md

@@ -1,9 +1,5 @@
 # List Workspaces
 
-List all existing workspaces managed by workspace-manager.
-
-## Instructions
-
 1. Run:
    ```bash
    nemus list
@@ -20,8 +16,3 @@ List all existing workspaces managed by workspace-manager.
    - Archived status (if applicable)
 
 3. If no workspaces exist, suggest creating one with `nemus create`.
-
-## Success Criteria
-
-- All active workspaces are listed with repo count and creation date.
-- Archived workspaces are shown only when explicitly requested.