@nemus-cli/nemus 0.2.5 → 0.2.6

package/CHANGELOG.md

@@ -7,6 +7,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.6] - 2026-08-25
+
+### Changed
+
+- **Skills are now command-first ("one shot").** Each skill's body no longer
+  restates its frontmatter `description` under a heading before the command — it
+  leads straight with the command(s). Cut the skills corpus a further ~25%
+  (~1724 → ~1300 lines) with no loss of actual guidance.
+- Fixed an unclosed code fence in the `save-context` skill.
+
+### Added
+
+- `assets/social-preview.png` (1280×640) and `assets/avatar-500.png` (500×500)
+  for the GitHub repo social preview and org/profile avatar.
+
 ## [0.2.5] - 2026-08-25
 
 ### Changed
@@ -147,7 +162,8 @@ Initial open-source release of **Nemus**.
 - Automatic retries with backoff on flaky network operations.
 - Optional shell integration (auto-cd on create + quick-navigate helper).
 
-[Unreleased]: https://github.com/me-public/nemus/compare/v0.2.5...HEAD
+[Unreleased]: https://github.com/me-public/nemus/compare/v0.2.6...HEAD
+[0.2.6]: https://github.com/me-public/nemus/compare/v0.2.5...v0.2.6
 [0.2.5]: https://github.com/me-public/nemus/compare/v0.2.4...v0.2.5
 [0.2.4]: https://github.com/me-public/nemus/compare/v0.2.3...v0.2.4
 [0.2.3]: https://github.com/me-public/nemus/compare/v0.2.2...v0.2.3

package/assets/README.md

@@ -51,3 +51,8 @@ rsvg-convert -w 1280 -h 640 banner.svg -o banner.png
 ```
 
 All artwork is original and released under the project's [MIT license](../LICENSE).
+
+## GitHub images
+
+- `social-preview.png` (1280×640) — upload at **Repo → Settings → General → Social preview** (shown in link unfurls).
+- `avatar-500.png` (500×500) — square icon for use as an **org/profile avatar** if desired.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nemus-cli/nemus",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "description": "Nemus — a CLI for managing multi-repository workspaces. Create, sync, and operate across dozens of repos with a single command, and wire them up to your favorite coding agent.",
   "keywords": [
     "workspace",

package/skills/analyze-deps.md

@@ -3,12 +3,6 @@ name: analyze-deps
 description: Analyze inter-repository dependencies in a workspace
 ---
 
-# Analyze Dependencies
-
-Analyze inter-repository dependencies in a workspace.
-
-## Running
-
 ```bash
 nemus analyze-deps <workspace-name>
 ```
@@ -17,4 +11,3 @@ Or for the current workspace:
 ```bash
 nemus analyze-deps
 ```
-

package/skills/archive-workspace.md

@@ -3,18 +3,10 @@ name: archive-workspace
 description: Archive or unarchive a workspace
 ---
 
-# Archive Workspace
-
-Archive or unarchive a workspace.
-
-## Archiving
-
 ```bash
 nemus archive <workspace-name>
 ```
 
-## Unarchiving
-
 ```bash
 nemus archive --unarchive <workspace-name>
 ```

package/skills/branch-create.md

@@ -3,13 +3,6 @@ name: branch-create
 description: Create a new branch across all repos in a workspace
 ---
 
-# Branch Create
-
-Create a new branch across all repos in a workspace.
-
-## Running
-
 ```bash
 nemus branch create <workspace-name> <branch-name>
 ```
-

package/skills/create-workspace.md

@@ -3,19 +3,11 @@ name: create-workspace
 description: Create a new multi-repo workspace by cloning repositories from the org using `nemus create`. ALWAYS use this skill — never run `git clone` directly — when the user asks to create a workspace, set up a new workspace, or start fresh with a set of repos.
 ---
 
-# Create Workspace
-
-Create a new workspace by cloning repositories.
-
-## Resolving Repositories
-
 If the user hasn't specified which repos to clone, help them discover:
 ```bash
 nemus cache search <keyword>
 ```
 
-## Creating the Workspace
-
 Run non-interactively:
 ```bash
 nemus create --workspace <name> --repos <repo1,repo2,...> --yes
@@ -25,4 +17,3 @@ Or interactively (prompts for workspace name and repos):
 ```bash
 nemus create
 ```
-

package/skills/delete-workspace.md

@@ -3,19 +3,11 @@ name: delete-workspace
 description: Delete one or more workspaces and all their contents permanently
 ---
 
-# Delete Workspace
-
-Delete one or more workspaces permanently.
-
-## Resolving the Workspace
-
 If the user hasn't specified which workspace to delete:
 ```bash
 nemus list 2>&1 | cat
 ```
 
-## Deleting
-
 Run non-interactively:
 ```bash
 nemus delete --workspace <name> --yes
@@ -26,9 +18,6 @@ Or interactively (prompts for confirmation):
 nemus delete
 ```
 
-## Important Notes
-
 - This permanently removes the workspace directory and all its contents
 - There is no undo — repos will need to be re-cloned
 - Always confirm with the user before deleting
-

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,4 +11,3 @@ If the cache is empty or stale:
 ```bash
 nemus cache refresh
 ```
-

package/skills/list-suites.md

@@ -3,12 +3,6 @@ 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
 ```

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,4 +11,3 @@ Note: This command opens an interactive picker. To just see the output without s
 ```bash
 nemus list 2>&1 | cat
 ```
-

package/skills/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,15 +16,11 @@ 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`)
 

package/skills/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,4 +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
-

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

@@ -1,15 +1,9 @@
 # Archive Workspace
 
-Archive a workspace to hide it from default listings. Archived workspaces auto-delete after 30 days.
-
-## Instructions
-
-### Archive
 ```bash
 nemus archive --workspace <name> --yes
 ```
 
-### Unarchive
 ```bash
 nemus archive --unarchive --workspace <name> --yes
 ```
@@ -26,4 +20,3 @@ nemus list --archived
 | `--workspace <name>` | `-w` | Workspace name(s), comma-separated for multiple |
 | `--yes` | `-y` | Skip confirmation prompt |
 | `--unarchive` | | Restore instead of archive |
-

package/skills/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,4 +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.
-

package/skills/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,4 +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.
-

package/skills/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,4 +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.
-

package/skills/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,4 +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.
-

package/skills/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,4 +12,3 @@ View cache statistics including repo count, age, and size.
    - Cache size
 
 3. If cache is stale or missing, suggest `nemus cache refresh`.
-

package/skills/nemus/references/configure-claude.md

@@ -1,9 +1,5 @@
 # Configure Claude
 
-Configure Claude Code integration settings.
-
-## Instructions
-
 ```bash
 nemus configure-claude
 ```
@@ -25,4 +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.
-

package/skills/nemus/references/configure.md

@@ -1,9 +1,5 @@
 # Configure
 
-Configure Nemus global settings interactively.
-
-## Instructions
-
 ```bash
 nemus configure
 ```
@@ -29,4 +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.
-

package/skills/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,4 +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
 ```
-

package/skills/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,22 +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
-

package/skills/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,4 +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 |
-

package/skills/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,10 +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
-

package/skills/nemus/references/ghq-status.md

@@ -1,23 +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
-

package/skills/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,9 +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
-

package/skills/nemus/references/history.md

@@ -1,11 +1,5 @@
 # History
 
-View operation history for Nemus commands.
-
-## Instructions
-
-### Show Recent History
-
 ```bash
 nemus history
 nemus history show 50           # last 50 records
@@ -13,25 +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
 ```
-

package/skills/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,4 +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.
-

package/skills/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,4 +10,3 @@ To create a workspace from a suite (non-interactive):
 ```bash
 nemus suite use --suite <suite-name> --workspace <workspace-name> --yes
 ```
-

package/skills/nemus/references/list-workspaces.md

@@ -1,9 +1,5 @@
 # List Workspaces
 
-List all existing workspaces managed by Nemus.
-
-## Instructions
-
 1. Run:
    ```bash
    nemus list
@@ -20,4 +16,3 @@ List all existing workspaces managed by Nemus.
    - Archived status (if applicable)
 
 3. If no workspaces exist, suggest creating one with `nemus create`.
-

package/skills/nemus/references/mcp.md

@@ -1,11 +1,5 @@
 # MCP Server
 
-Manage the MCP (Model Context Protocol) server integration with Claude Code.
-
-## Commands
-
-### Install
-
 Register the Nemus MCP server with Claude Code:
 ```bash
 nemus mcp install
@@ -13,15 +7,11 @@ nemus mcp install
 
 This also installs shell integration, permission sync hooks, and workspace skills.
 
-### Uninstall
-
 Remove the MCP server registration:
 ```bash
 nemus mcp uninstall
 ```
 
-### Upgrade
-
 Update hooks and skills without re-registering the MCP server:
 ```bash
 nemus mcp upgrade
@@ -29,8 +19,6 @@ nemus mcp upgrade
 
 Use after updating the Nemus package.
 
-### Status
-
 Check if the MCP server is registered:
 ```bash
 nemus mcp status
@@ -41,4 +29,3 @@ nemus mcp status
 When installed, Claude Code gains access to Nemus tools:
 - `create-workspace`, `list-workspaces`, `workspace-status`, etc.
 - Enables natural language workspace management via `nemus -- <prompt>`
-

package/skills/nemus/references/remove-repo.md

@@ -1,9 +1,5 @@
 # Remove Repo
 
-Remove a repository instance from a workspace.
-
-## Instructions
-
 1. Warn the user about any uncommitted changes before removing.
 
 2. Run the command:
@@ -20,4 +16,3 @@ Remove a repository instance from a workspace.
 | `--workspace <name>` | `-w` | Target workspace |
 | `--repos <dir,...>` | `-r` | Comma-separated directory names to remove |
 | `--yes` | `-y` | Skip confirmation prompt |
-

package/skills/nemus/references/run-command.md

@@ -1,9 +1,5 @@
 # Run Command
 
-Run a shell command across all repositories in a workspace (3 concurrent, 5 minute timeout per repo).
-
-## Instructions
-
 ```bash
 nemus run <workspace> <command>
 ```
@@ -37,4 +33,3 @@ Shows per-repo results:
 - Summary count of successes and failures
 
 Exits with code 1 if any repo failed.
-