npcsh 1.1.22__tar.gz → 1.1.23__tar.gz

{npcsh-1.1.22/npcsh.egg-info → npcsh-1.1.23}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: npcsh
-Version: 1.1.22
+Version: 1.1.23
 Summary: npcsh is a command-line toolkit for using AI agents in novel ways.
 Home-page: https://github.com/NPC-Worldwide/npcsh
 Author: Christopher Agostino
@@ -167,10 +167,11 @@ Once installed, run `npcsh` to enter the NPC shell. The pip installation also pr
   - **Computer Use**
 
     ```bash
-    /plonk 'find out the latest news on cnn' gemma3:12b ollama
+    /plonk 
     ```
     <p align="center">
-        <img src="gh_images/plonk.png" alt="Plonk GUI automation TUI", width=500>
+        <img src="gh_images/plonk.png" alt="Plonk GUI automation TUI — task entry" width=500>
+        <img src="gh_images/plonk_task.png" alt="Plonk GUI automation — completed flight search task" width=500>
     </p>
 
   - **Generate Images with Vixynt**
@@ -189,11 +190,14 @@ Once installed, run `npcsh` to enter the NPC shell. The pip installation also pr
       <p align="center">
         <img src="https://raw.githubusercontent.com/npc-worldwide/npcsh/main/test_data/rabbit.PNG" alt="a rabbit eating ham in the bring of dawn", width=350>
       </p>
-  - **Generate Videos**
+  - **Generate Videos with Roll**
 
     ```bash
     /roll
     ```
+    <p align="center">
+        <img src="gh_images/roll.png" alt="Roll Video Creation Studio" width=500>
+    </p>
 
   - Generate videos directly
 
@@ -205,6 +209,16 @@ Once installed, run `npcsh` to enter the NPC shell. The pip installation also pr
         <img src="https://raw.githubusercontent.com/NPC-Worldwide/npcsh/main/test_data/hatridingdog.gif" alt="video of a hat riding a dog", width=350>
       </p> 
 
+  - **Multi-Agent Discussions**
+
+    ```bash
+    /convene "Is the universe a simulation?" npcs=alicanto,corca,guac rounds=3
+    ```
+    <p align="center">
+        <img src="gh_images/convene.png" alt="Convene — multi-NPC structured discussion" width=500>
+        <img src="gh_images/convene_convene.png" alt="Convene — live discussion view" width=500>
+    </p>
+
   - **Serve an NPC Team**
     ```bash
     /serve --port 5337 --cors='http://localhost:5137/'
@@ -288,6 +302,108 @@ When an NPC is invoked, they can only use the jinxs assigned to them. This creat
 
 The forenpc (orchestrator) can delegate to any team member based on their specialization.
 
+## Skills — Knowledge Content for Agents
+
+Skills are jinxs that serve instructional content instead of executing code. They use the `skill.jinx` sub-jinx (just like code jinxs use `python.jinx` or `sh.jinx`) and return sections of methodology on demand.
+
+Because skills are jinxs, they're assigned to agents the same way — through the `jinxs:` list in `.npc` files:
+
+```yaml
+# reviewer.npc
+name: reviewer
+primary_directive: "You review code and provide feedback."
+jinxs:
+  - lib/core/sh
+  - lib/core/python
+  - skills/code-review
+  - skills/debugging
+```
+
+The agent sees `code-review` and `debugging` in its tool catalog alongside `sh` and `python`. When it encounters a review task, it calls the skill to get methodology, then uses `sh` or `python` to do the actual work.
+
+### Two Authoring Formats
+
+**SKILL.md folder** — a folder with a `SKILL.md` file (folder name = skill name):
+
+```
+jinxs/skills/debugging/
+  SKILL.md             # YAML frontmatter + ## sections
+  scripts/             # Optional
+  references/          # Optional
+```
+
+```markdown
+---
+description: Debugging methodology. Use when asked to debug or troubleshoot.
+---
+# Debugging
+
+## reproduce
+First, reproduce the bug consistently.
+Find the minimal reproduction case.
+
+## isolate
+Binary search through the codebase (git bisect).
+Comment out components to isolate the cause.
+
+## fix
+Fix the root cause, not the symptom.
+Add a test that fails without the fix.
+```
+
+**`.jinx` file** — a regular jinx with `engine: skill` steps:
+
+```yaml
+jinx_name: git-workflow
+description: "Git workflow best practices. [Sections: branching, commits, merging]"
+inputs:
+- section: all
+steps:
+  - engine: skill
+    skill_name: git-workflow
+    skill_description: Git workflow best practices.
+    sections:
+      branching: |
+        Use feature branches off main/develop.
+        Name branches: feature/, fix/, chore/
+      commits: |
+        Imperative summary under 72 chars.
+        One logical change per commit.
+      merging: |
+        Prefer squash merges for feature branches.
+        Delete branches after merging.
+    scripts_json: '[]'
+    references_json: '[]'
+    assets_json: '[]'
+    section: '{{section}}'
+```
+
+### Using Skills
+
+In npcsh, skills work as slash commands like any jinx:
+
+```bash
+/debugging                       # All sections
+/debugging -s reproduce          # Just the reproduce section
+/debugging -s list               # Available section names
+/code-review -s correctness      # Just the correctness section
+```
+
+In the agent loop, the agent calls skills automatically when relevant — requesting specific sections to minimize token usage (progressive disclosure).
+
+### Importing External Skills
+
+Add `SKILLS_DIRECTORY` to your `.ctx` file to load skills from an external directory:
+
+```yaml
+model: llama3.2
+provider: ollama
+forenpc: lead-dev
+SKILLS_DIRECTORY: ~/shared-skills
+```
+
+All `SKILL.md` folders and `.jinx` skill files in that directory are loaded alongside the team's own jinxs. This lets you maintain a single skills library shared across multiple teams.
+
 ## Delegation with Review Loop
 
 The `/delegate` jinx sends a task to another NPC with automatic review and feedback:
@@ -581,14 +697,15 @@ npc sample "a sunset over mountains"
 | `/git` | Git integration TUI |
 | `/build` | Build team to deployable format (flask, docker, cli, static) |
 | `/team` | Team config browser — context, NPCs, jinxs |
-| `/config_tui` | Interactive config editor |
+| `/config` | Interactive config editor |
 | `/reattach` | Resume previous conversation sessions |
 | `/delegate` | Delegate task to NPC with review loop |
 | `/web_search` | Web search |
 | `/db_search` | Database search |
 | `/file_search` | File search |
 | `/vixynt` | Generate/edit images |
-| `/roll` | Generate videos |
+| `/roll` | Video creation studio |
+| `/crond` | System task manager (cron, daemons, processes) |
 | `/sample` | Context-free LLM prompt |
 | `/serve` | Serve NPC team as API with OpenAI-compatible endpoints |
 | `/compile` | Compile NPC profiles |
@@ -642,6 +759,44 @@ Browse all available models across providers (Ollama, OpenAI, Anthropic, etc.),
     <img src="gh_images/models.png" alt="Models browser", width=500>
 </p>
 
+### `/roll` — Video Creation Studio
+Interactive TUI for generating videos with parameter controls. Edit prompt, model, provider, dimensions, and frame count, then generate. Includes a gallery browser for previously generated videos.
+
+```bash
+/roll                    # Open interactive TUI
+/roll "a sunset"         # Generate video directly (one-shot mode)
+```
+
+<p align="center">
+    <img src="gh_images/roll.png" alt="Roll Video Creation Studio" width=500>
+</p>
+
+### `/config` — Configuration Editor
+Interactive TUI for editing `~/.npcshrc` settings — models, providers, modes, and toggles. Navigate with j/k, edit text fields, toggle booleans, and cycle choices.
+
+```bash
+/config
+```
+
+<p align="center">
+    <img src="gh_images/config.png" alt="Config editor TUI" width=500>
+</p>
+
+### `/crond` — System Task Manager
+Multi-tab TUI for managing cron jobs, systemd user daemons, and system processes. Create new cron jobs and daemons using natural language, start/stop/restart services, kill processes, and monitor resource usage.
+
+```bash
+/crond
+```
+
+<p align="center">
+    <img src="gh_images/crond.png" alt="Crond Cron tab" width=500>
+    <img src="gh_images/crondaemon.png" alt="Crond Daemons tab" width=500>
+</p>
+<p align="center">
+    <img src="gh_images/cron_processes.png" alt="Crond Processes tab" width=500>
+</p>
+
 # Memory & Knowledge Graph
 
 `npcsh` maintains a memory lifecycle system that allows agents to learn and grow from past interactions. Memories progress through stages and can be incorporated into a knowledge graph for advanced retrieval.
@@ -893,8 +1048,14 @@ export PERPLEXITY_API_KEY='your_perplexity_key'
 npc_team/
 ├── jinxs/
 │   ├── modes/            # TUI modes (alicanto, corca, kg, yap, etc.)
+│   ├── skills/           # Skills — knowledge-content jinxs
+│   │   ├── code-review/  # SKILL.md folder format
+│   │   │   └── SKILL.md
+│   │   ├── debugging/
+│   │   │   └── SKILL.md
+│   │   └── git-workflow.jinx  # .jinx format
 │   ├── lib/
-│   │   ├── core/         # Core tools (python, sh, sql, edit_file, delegate, etc.)
+│   │   ├── core/         # Core tools (python, sh, sql, skill, edit_file, delegate, etc.)
 │   │   │   └── search/   # Search tools (web_search, db_search, file_search)
 │   │   ├── utils/        # Utility jinxs (set, compile, serve, teamviz, etc.)
 │   │   ├── browser/      # Browser automation (browser_action, screenshot, etc.)

{npcsh-1.1.22 → npcsh-1.1.23}/README.md

@@ -62,10 +62,11 @@ Once installed, run `npcsh` to enter the NPC shell. The pip installation also pr
   - **Computer Use**
 
     ```bash
-    /plonk 'find out the latest news on cnn' gemma3:12b ollama
+    /plonk 
     ```
     <p align="center">
-        <img src="gh_images/plonk.png" alt="Plonk GUI automation TUI", width=500>
+        <img src="gh_images/plonk.png" alt="Plonk GUI automation TUI — task entry" width=500>
+        <img src="gh_images/plonk_task.png" alt="Plonk GUI automation — completed flight search task" width=500>
     </p>
 
   - **Generate Images with Vixynt**
@@ -84,11 +85,14 @@ Once installed, run `npcsh` to enter the NPC shell. The pip installation also pr
       <p align="center">
         <img src="https://raw.githubusercontent.com/npc-worldwide/npcsh/main/test_data/rabbit.PNG" alt="a rabbit eating ham in the bring of dawn", width=350>
       </p>
-  - **Generate Videos**
+  - **Generate Videos with Roll**
 
     ```bash
     /roll
     ```
+    <p align="center">
+        <img src="gh_images/roll.png" alt="Roll Video Creation Studio" width=500>
+    </p>
 
   - Generate videos directly
 
@@ -100,6 +104,16 @@ Once installed, run `npcsh` to enter the NPC shell. The pip installation also pr
         <img src="https://raw.githubusercontent.com/NPC-Worldwide/npcsh/main/test_data/hatridingdog.gif" alt="video of a hat riding a dog", width=350>
       </p> 
 
+  - **Multi-Agent Discussions**
+
+    ```bash
+    /convene "Is the universe a simulation?" npcs=alicanto,corca,guac rounds=3
+    ```
+    <p align="center">
+        <img src="gh_images/convene.png" alt="Convene — multi-NPC structured discussion" width=500>
+        <img src="gh_images/convene_convene.png" alt="Convene — live discussion view" width=500>
+    </p>
+
   - **Serve an NPC Team**
     ```bash
     /serve --port 5337 --cors='http://localhost:5137/'
@@ -183,6 +197,108 @@ When an NPC is invoked, they can only use the jinxs assigned to them. This creat
 
 The forenpc (orchestrator) can delegate to any team member based on their specialization.
 
+## Skills — Knowledge Content for Agents
+
+Skills are jinxs that serve instructional content instead of executing code. They use the `skill.jinx` sub-jinx (just like code jinxs use `python.jinx` or `sh.jinx`) and return sections of methodology on demand.
+
+Because skills are jinxs, they're assigned to agents the same way — through the `jinxs:` list in `.npc` files:
+
+```yaml
+# reviewer.npc
+name: reviewer
+primary_directive: "You review code and provide feedback."
+jinxs:
+  - lib/core/sh
+  - lib/core/python
+  - skills/code-review
+  - skills/debugging
+```
+
+The agent sees `code-review` and `debugging` in its tool catalog alongside `sh` and `python`. When it encounters a review task, it calls the skill to get methodology, then uses `sh` or `python` to do the actual work.
+
+### Two Authoring Formats
+
+**SKILL.md folder** — a folder with a `SKILL.md` file (folder name = skill name):
+
+```
+jinxs/skills/debugging/
+  SKILL.md             # YAML frontmatter + ## sections
+  scripts/             # Optional
+  references/          # Optional
+```
+
+```markdown
+---
+description: Debugging methodology. Use when asked to debug or troubleshoot.
+---
+# Debugging
+
+## reproduce
+First, reproduce the bug consistently.
+Find the minimal reproduction case.
+
+## isolate
+Binary search through the codebase (git bisect).
+Comment out components to isolate the cause.
+
+## fix
+Fix the root cause, not the symptom.
+Add a test that fails without the fix.
+```
+
+**`.jinx` file** — a regular jinx with `engine: skill` steps:
+
+```yaml
+jinx_name: git-workflow
+description: "Git workflow best practices. [Sections: branching, commits, merging]"
+inputs:
+- section: all
+steps:
+  - engine: skill
+    skill_name: git-workflow
+    skill_description: Git workflow best practices.
+    sections:
+      branching: |
+        Use feature branches off main/develop.
+        Name branches: feature/, fix/, chore/
+      commits: |
+        Imperative summary under 72 chars.
+        One logical change per commit.
+      merging: |
+        Prefer squash merges for feature branches.
+        Delete branches after merging.
+    scripts_json: '[]'
+    references_json: '[]'
+    assets_json: '[]'
+    section: '{{section}}'
+```
+
+### Using Skills
+
+In npcsh, skills work as slash commands like any jinx:
+
+```bash
+/debugging                       # All sections
+/debugging -s reproduce          # Just the reproduce section
+/debugging -s list               # Available section names
+/code-review -s correctness      # Just the correctness section
+```
+
+In the agent loop, the agent calls skills automatically when relevant — requesting specific sections to minimize token usage (progressive disclosure).
+
+### Importing External Skills
+
+Add `SKILLS_DIRECTORY` to your `.ctx` file to load skills from an external directory:
+
+```yaml
+model: llama3.2
+provider: ollama
+forenpc: lead-dev
+SKILLS_DIRECTORY: ~/shared-skills
+```
+
+All `SKILL.md` folders and `.jinx` skill files in that directory are loaded alongside the team's own jinxs. This lets you maintain a single skills library shared across multiple teams.
+
 ## Delegation with Review Loop
 
 The `/delegate` jinx sends a task to another NPC with automatic review and feedback:
@@ -476,14 +592,15 @@ npc sample "a sunset over mountains"
 | `/git` | Git integration TUI |
 | `/build` | Build team to deployable format (flask, docker, cli, static) |
 | `/team` | Team config browser — context, NPCs, jinxs |
-| `/config_tui` | Interactive config editor |
+| `/config` | Interactive config editor |
 | `/reattach` | Resume previous conversation sessions |
 | `/delegate` | Delegate task to NPC with review loop |
 | `/web_search` | Web search |
 | `/db_search` | Database search |
 | `/file_search` | File search |
 | `/vixynt` | Generate/edit images |
-| `/roll` | Generate videos |
+| `/roll` | Video creation studio |
+| `/crond` | System task manager (cron, daemons, processes) |
 | `/sample` | Context-free LLM prompt |
 | `/serve` | Serve NPC team as API with OpenAI-compatible endpoints |
 | `/compile` | Compile NPC profiles |
@@ -537,6 +654,44 @@ Browse all available models across providers (Ollama, OpenAI, Anthropic, etc.),
     <img src="gh_images/models.png" alt="Models browser", width=500>
 </p>
 
+### `/roll` — Video Creation Studio
+Interactive TUI for generating videos with parameter controls. Edit prompt, model, provider, dimensions, and frame count, then generate. Includes a gallery browser for previously generated videos.
+
+```bash
+/roll                    # Open interactive TUI
+/roll "a sunset"         # Generate video directly (one-shot mode)
+```
+
+<p align="center">
+    <img src="gh_images/roll.png" alt="Roll Video Creation Studio" width=500>
+</p>
+
+### `/config` — Configuration Editor
+Interactive TUI for editing `~/.npcshrc` settings — models, providers, modes, and toggles. Navigate with j/k, edit text fields, toggle booleans, and cycle choices.
+
+```bash
+/config
+```
+
+<p align="center">
+    <img src="gh_images/config.png" alt="Config editor TUI" width=500>
+</p>
+
+### `/crond` — System Task Manager
+Multi-tab TUI for managing cron jobs, systemd user daemons, and system processes. Create new cron jobs and daemons using natural language, start/stop/restart services, kill processes, and monitor resource usage.
+
+```bash
+/crond
+```
+
+<p align="center">
+    <img src="gh_images/crond.png" alt="Crond Cron tab" width=500>
+    <img src="gh_images/crondaemon.png" alt="Crond Daemons tab" width=500>
+</p>
+<p align="center">
+    <img src="gh_images/cron_processes.png" alt="Crond Processes tab" width=500>
+</p>
+
 # Memory & Knowledge Graph
 
 `npcsh` maintains a memory lifecycle system that allows agents to learn and grow from past interactions. Memories progress through stages and can be incorporated into a knowledge graph for advanced retrieval.
@@ -788,8 +943,14 @@ export PERPLEXITY_API_KEY='your_perplexity_key'
 npc_team/
 ├── jinxs/
 │   ├── modes/            # TUI modes (alicanto, corca, kg, yap, etc.)
+│   ├── skills/           # Skills — knowledge-content jinxs
+│   │   ├── code-review/  # SKILL.md folder format
+│   │   │   └── SKILL.md
+│   │   ├── debugging/
+│   │   │   └── SKILL.md
+│   │   └── git-workflow.jinx  # .jinx format
 │   ├── lib/
-│   │   ├── core/         # Core tools (python, sh, sql, edit_file, delegate, etc.)
+│   │   ├── core/         # Core tools (python, sh, sql, skill, edit_file, delegate, etc.)
 │   │   │   └── search/   # Search tools (web_search, db_search, file_search)
 │   │   ├── utils/        # Utility jinxs (set, compile, serve, teamviz, etc.)
 │   │   ├── browser/      # Browser automation (browser_action, screenshot, etc.)