llm-party-cli 0.4.0 → 0.5.1

package/README.md

@@ -256,13 +256,14 @@ Override with `LLM_PARTY_CONFIG` env var to point to a different file.
 | Field              | Required | Default                  | Description                                                                                         |
 | ------------------ | -------- | ------------------------ | --------------------------------------------------------------------------------------------------- |
 | `name`           | Yes      |                          | Display name shown in responses as `[AGENT NAME]`. Must be unique.                                |
-| `tag`            | No       | derived from `name`    | Routing tag for `@tag` targeting                                                                  |
+| `tag`            | Yes      |                        | Routing tag for `@tag` targeting. Letters, numbers, hyphens, underscores only. No spaces.         |
 | `provider`       | Yes      |                          | SDK adapter:`claude`, `codex`, `copilot`, or `glm`                                          |
 | `model`          | Yes      |                          | Model ID passed to the provider. Examples:`opus`, `sonnet`, `gpt-5.2`, `gpt-4.1`, `glm-5` |
 | `prompts`        | No       | none                     | Array of extra prompt file paths, concatenated after `base.md`. Relative to project root          |
 | `executablePath` | No       | PATH lookup              | Path to the CLI binary. Supports `~/`. Only needed if the CLI is not in your PATH                 |
 | `env`            | No       | inherits `process.env` | Environment variable overrides for this agent                                                       |
 | `timeout`        | No       | top-level value          | Per-agent timeout override in seconds                                                               |
+| `preloadSkills`  | No       | none                     | Array of skill names to load at boot. Skills are discovered from `~/.llm-party/skills/`, `.llm-party/skills/`, `.claude/skills/`, `.agents/skills/` |
 
 ### Prompts
 
@@ -291,6 +292,7 @@ Template variables available in prompt files:
 | `{{allAgentTags}}`        | All agent tags as `@tag`    |
 | `{{otherAgentList}}`      | Other agents with their tags  |
 | `{{validHandoffTargets}}` | Valid `@next:tag` targets   |
+| `{{preloadedSkills}}`     | Skills assigned to this agent via `preloadSkills` |
 
 ### GLM environment setup
 
@@ -313,6 +315,38 @@ GLM requires environment overrides to route through a proxy. The adapter tries t
 
 <br/>
 
+## Skills
+
+Skills are folders containing a `SKILL.md` file with specialized instructions for specific workflows. Agents discover skills from these locations (in order):
+
+1. `~/.llm-party/skills/` (global, shared across all projects)
+2. `.llm-party/skills/` (project-local)
+3. `.claude/skills/` (if present)
+4. `.agents/skills/` (if present)
+
+Assign skills to agents with `preloadSkills` in config:
+
+```json
+{
+  "name": "Reviewer",
+  "provider": "claude",
+  "model": "opus",
+  "preloadSkills": ["aala-review"]
+}
+```
+
+At boot, the orchestrator verifies each skill exists and reports status per agent. Skills assigned to an agent are also shown in the team directory visible to all peers.
+
+<br/>
+
+## Mind-map
+
+Shared memory between all agents, stored as Obsidian-compatible notes in `~/.llm-party/network/mind-map/`. Each entry is a `.md` file with frontmatter and `[[wikilinks]]` connecting related findings. `INDEX.md` is the entry point that agents read on boot.
+
+Agents write to the mind-map as they work: constraints, discoveries, session progress, cross-project breadcrumbs, user preferences. Anything a cold-boot agent would need to know that is not in the code. Open the folder in Obsidian to visualize the knowledge graph.
+
+<br/>
+
 ## Session and transcript
 
 Every run generates a unique session ID and appends messages to a JSONL transcript in `.llm-party/sessions/` (project-level). The session ID and transcript path are printed at startup.
@@ -327,13 +361,21 @@ File changes made by agents are detected via `git status` after each response. N
 | ---------------- | -------------------------------------------- |
 | `/agents`      | Open agents panel overlay (Ctrl+P also works) |
 | `/config`      | Open config wizard                                |
+| `/info`        | Commands and keyboard shortcuts panel             |
 | `/save <path>` | Export conversation as JSON                       |
 | `/session`     | Show session ID and transcript path               |
 | `/changes`     | Show git-modified files                           |
 | `/clear`       | Clear chat display (Ctrl+L also works)            |
 | `/exit`        | Quit (graceful shutdown, all adapters cleaned up) |
 | `Ctrl+P`       | Toggle agents panel                               |
-| `Ctrl+C`       | Exit (or copy selected text if selection active)  |
+| `Ctrl+L`       | Clear chat                                        |
+| `Ctrl+C`       | Copy selection or exit                            |
+| `Ctrl+A / E`   | Jump to start / end of input line                 |
+| `Ctrl+U`       | Clear entire input line                           |
+| `Ctrl+W`       | Delete word backward                              |
+| `Shift+Enter`  | Insert new line in input                          |
+| `Up / Down`    | Input history                                     |
+| `PageUp/Down`  | Scroll chat                                       |
 
 <br/>