thepopebot 1.2.75-beta.19 → 1.2.75-beta.20

package/bin/cli.js

@@ -284,8 +284,8 @@ async function init() {
   for (const skill of defaultSkills) {
     const symlink = path.join(activeDir, skill);
     if (!fs.existsSync(symlink)) {
-      createDirLink(`../${skill}`, symlink);
-      console.log(`  Created skills/active/${skill} → ../${skill}`);
+      createDirLink(`../library/${skill}`, symlink);
+      console.log(`  Created skills/active/${skill} → ../library/${skill}`);
     }
   }
 

package/lib/chat/components/chat-input.js

@@ -88,6 +88,7 @@ function ChatInput({ input, setInput, onSubmit, status, stop, files, setFiles, d
     if (!textarea) return;
     textarea.style.height = "auto";
     textarea.style.height = `${textarea.scrollHeight}px`;
+    textarea.scrollTop = textarea.scrollHeight;
   }, []);
   useEffect(() => {
     adjustHeight();

package/lib/chat/components/chat-input.jsx

@@ -70,6 +70,7 @@ export function ChatInput({ input, setInput, onSubmit, status, stop, files, setF
     if (!textarea) return;
     textarea.style.height = 'auto';
     textarea.style.height = `${textarea.scrollHeight}px`;
+    textarea.scrollTop = textarea.scrollHeight;
   }, []);
 
   useEffect(() => {

package/lib/code/terminal-view.js

@@ -54,6 +54,7 @@ function TerminalView({ codeWorkspaceId, wsPath, isActive = true, showToolbar =
   const [voiceText, setVoiceText] = useState("");
   const [partialText, setPartialText] = useState("");
   const voiceDialogRef = useRef(null);
+  const voiceTextareaRef = useRef(null);
   const volumeRef = useRef(0);
   const { voiceAvailable, isConnecting, isRecording, startRecording, stopRecording } = useVoiceInput({
     getToken: getVoiceToken,
@@ -318,6 +319,11 @@ function TerminalView({ codeWorkspaceId, wsPath, isActive = true, showToolbar =
     document.addEventListener("keydown", handler);
     return () => document.removeEventListener("keydown", handler);
   }, [voiceDialogOpen, closeVoiceDialog]);
+  useEffect(() => {
+    if (voiceTextareaRef.current) {
+      voiceTextareaRef.current.scrollTop = voiceTextareaRef.current.scrollHeight;
+    }
+  }, [voiceText, partialText]);
   const themeIcon = termTheme === "light" ? /* @__PURE__ */ jsxs("svg", { width: "14", height: "14", viewBox: "0 0 16 16", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", children: [
     /* @__PURE__ */ jsx("circle", { cx: "8", cy: "8", r: "3" }),
     /* @__PURE__ */ jsx("line", { x1: "8", y1: "1", x2: "8", y2: "3" }),
@@ -638,6 +644,7 @@ function TerminalView({ codeWorkspaceId, wsPath, isActive = true, showToolbar =
                   /* @__PURE__ */ jsx(
                     "textarea",
                     {
+                      ref: voiceTextareaRef,
                       rows: 6,
                       value: voiceText + (partialText ? (voiceText && !voiceText.endsWith(" ") ? " " : "") + partialText : ""),
                       onChange: (e) => {

package/lib/code/terminal-view.jsx

@@ -64,6 +64,7 @@ export default function TerminalView({ codeWorkspaceId, wsPath, isActive = true,
   const [voiceText, setVoiceText] = useState('');
   const [partialText, setPartialText] = useState('');
   const voiceDialogRef = useRef(null);
+  const voiceTextareaRef = useRef(null);
   const volumeRef = useRef(0);
 
   const { voiceAvailable, isConnecting, isRecording, startRecording, stopRecording } = useVoiceInput({
@@ -378,6 +379,13 @@ export default function TerminalView({ codeWorkspaceId, wsPath, isActive = true,
     return () => document.removeEventListener('keydown', handler);
   }, [voiceDialogOpen, closeVoiceDialog]);
 
+  // Auto-scroll voice textarea to bottom as text grows
+  useEffect(() => {
+    if (voiceTextareaRef.current) {
+      voiceTextareaRef.current.scrollTop = voiceTextareaRef.current.scrollHeight;
+    }
+  }, [voiceText, partialText]);
+
   const themeIcon = termTheme === 'light' ? (
     <svg width="14" height="14" viewBox="0 0 16 16" fill="none" stroke="currentColor" strokeWidth="1.5" strokeLinecap="round">
       <circle cx="8" cy="8" r="3" />
@@ -710,6 +718,7 @@ export default function TerminalView({ codeWorkspaceId, wsPath, isActive = true,
                   {voiceDialogOpen && (
                     <div className="code-voice-dialog">
                       <textarea
+                        ref={voiceTextareaRef}
                         rows={6}
                         value={voiceText + (partialText ? (voiceText && !voiceText.endsWith(' ') ? ' ' : '') + partialText : '')}
                         onChange={(e) => { setVoiceText(e.target.value); setPartialText(''); }}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "thepopebot",
-  "version": "1.2.75-beta.19",
+  "version": "1.2.75-beta.20",
   "type": "module",
   "description": "Create autonomous AI agents with a two-layer architecture: Next.js Event Handler + Docker Agent.",
   "bin": {

package/templates/.gitignore.template

@@ -14,9 +14,6 @@
 # Pi system prompt (generated at runtime from SOUL.md)
 .pi/SYSTEM.md
 
-# Skills dependencies (installed at runtime in Docker for correct arch)
-skills/*/node_modules/
-
 # Dynamically activated skills (created at container runtime, not user config)
 skills/active/agent-job-secrets
 

package/templates/CLAUDE.md.template

@@ -5,9 +5,9 @@ This is a [thepopebot](https://github.com/stephengpope/thepopebot) project.
 ## Directories
 
 - **`agent-job/`** — Agent job configuration: system prompts (`SOUL.md`, `SYSTEM.md`), heartbeat prompt, and cron schedules (`CRONS.json`).
-- **`agents/`** — Custom agent definitions. Each subdirectory defines an agent.
+- **`agents/`** — Custom agent definitions. Each subdirectory defines an agent (see Managing Agents below).
 - **`event-handler/`** — Event handler configuration: chat system prompts, trigger definitions (`TRIGGERS.json`), cluster templates, and LiteLLM proxy config.
-- **`skills/`** — Skill plugins. Activate by symlinking into `skills/active/`.
+- **`skills/library/`** — Skill plugins. Activate by symlinking into `skills/active/`.
 - **`data/`** — Runtime data (SQLite database, cluster state). Not checked into git.
 - **`logs/`** — Agent job logs, organized by job ID. Not checked into git.
 
@@ -29,3 +29,7 @@ Some files are auto-synced by `npx thepopebot init` and will be overwritten on u
 - `agents/CLAUDE.md`
 - `event-handler/CLAUDE.md`
 - `skills/CLAUDE.md`
+
+## Agents
+
+(No agents configured yet.)

package/templates/agent-job/SYSTEM.md

@@ -9,18 +9,16 @@ Your workspace is `/home/coding-agent/workspace` — a live git repository.
 ## Temporary Files
 Use `/home/coding-agent/workspace/.tmp/` for working files — downloads, screenshots, intermediate data, scripts, generated files. `/home/coding-agent/workspace/.tmp/` is gitignored and nothing there gets committed. If a tool downloads a file, save it to `/home/coding-agent/workspace/.tmp/` and reference it directly.
 
-**DO NOT USE** `/tmp` because that will continue waste disk space writing extra layers to the container.
+**DO NOT USE** `/tmp` because that will leak and waste disk space from writing extra layers to the container.
 
 Everything in the workspace is automatically committed and pushed when your job finishes. You do not control this. Be intentional about what you put here — **any file you create, move, or download into the workspace WILL be committed.**
 
-Current datetime: {{datetime}}
-
 ## Directory Layout
 
 - `agents/` — Agent definitions. Each subdirectory defines an agent with its own prompts.
 - `agent-job/` — Runtime config: system prompts (`SOUL.md`, `SYSTEM.md`), cron schedules (`CRONS.json`), heartbeat prompt.
 - `event-handler/` — Event handler config. Do not edit — managed by the event handler.
-- `skills/` — Skill plugins. Active skills are symlinked into `skills/active/`.
+- `skills/library/` — Skill plugins. Active skills are symlinked into `skills/active/`.
 - `data/`, `logs/` — Runtime data and job logs.
 
 ## What You Can Edit
@@ -39,13 +37,13 @@ Current datetime: {{datetime}}
 
 ## Self-Modification
 
-**Add an agent** — Create `agents/<name>/` with a `prompts/` subfolder, add a cron entry in `agent-job/CRONS.json` pointing to the prompt file, update `agents/CLAUDE.md` to document it, update root `CLAUDE.md` to reflect the new agent.
+**Add an agent** — Create `agents/<name>/` with a `jobs/` subfolder, add a cron entry in `agent-job/CRONS.json` pointing to the prompt file, update `agents/CLAUDE.md` to document it, update root `CLAUDE.md` to reflect the new agent.
 
 **Remove an agent** — Delete the `agents/<name>/` folder, remove its cron entries, update `agents/CLAUDE.md` and root `CLAUDE.md`.
 
 **Change a schedule** — Edit `agent-job/CRONS.json` (cron expressions, enable/disable).
 
-**Activate a skill** — Symlink from `skills/<name>/` into `skills/active/`, update root `CLAUDE.md`.
+**Activate a skill** — Symlink from `skills/library/<name>/` into `skills/active/`, update root `CLAUDE.md`.
 
 **Deactivate a skill** — Remove the symlink from `skills/active/`, update root `CLAUDE.md`.
 
@@ -58,3 +56,5 @@ Current datetime: {{datetime}}
 ## Orientation
 
 Read the root `CLAUDE.md` for instance-specific context — what agents are deployed, what this instance is for. Read the `CLAUDE.md` in each folder you work in for local conventions.
+
+Current datetime: {{datetime}}

package/templates/agents/CLAUDE.md.template

@@ -1,5 +1,54 @@
 # agents/ — Custom Agent Definitions
 
-This directory holds custom agent configurations. Each subdirectory defines an agent that can be referenced by agent jobs and cron tasks.
+## Adding an Agent
 
-(No agents configured yet — add a subdirectory here to define one.)
+Each subdirectory defines an agent. Create a folder with a `SYSTEM.md` file:
+
+```
+agents/
+└── my-agent/
+    └── SYSTEM.md        # System prompt — identity, instructions, constraints
+```
+
+`SYSTEM.md` is the agent's system prompt. Write it in markdown addressed to the agent (e.g. "You are a code reviewer...").
+
+For agents with multiple complex tasks, add a `jobs/` subfolder:
+
+```
+agents/
+└── my-agent/
+    ├── SYSTEM.md
+    └── jobs/
+        ├── weekly-report.md
+        └── cleanup.md
+```
+
+## Scheduling
+
+Add a cron entry in `agent-job/CRONS.json`:
+
+```json
+{
+  "name": "my-agent-daily",
+  "schedule": "0 9 * * *",
+  "type": "agent",
+  "job": "Read agents/my-agent/SYSTEM.md and follow the instructions there.",
+  "enabled": true
+}
+```
+
+For job-specific prompts, chain the reads:
+
+```json
+{
+  "name": "my-agent-report",
+  "schedule": "0 9 * * 1",
+  "type": "agent",
+  "job": "Read agents/my-agent/SYSTEM.md for context, then read agents/my-agent/prompts/weekly-report.md and complete that task.",
+  "enabled": true
+}
+```
+
+## Removing an Agent
+
+Delete the `agents/<name>/` folder and remove its cron entries from `agent-job/CRONS.json`.

package/templates/skills/CLAUDE.md.template

@@ -1,6 +1,6 @@
 # skills/ — Agent Skills
 
-Skills are lightweight plugins that extend agent abilities. Each skill lives in `skills/<skill-name>/` and is activated by symlinking into `skills/active/`.
+Skills are lightweight plugins that extend agent abilities. Each skill lives in `skills/library/<skill-name>/` and is activated by symlinking into `skills/active/`.
 
 ## How Skills Work
 
@@ -48,12 +48,12 @@ description: One sentence describing what the skill does and when to use it.
 ## Usage
 
 ```bash
-skills/skill-name/script.sh <args>
+skills/library/skill-name/script.sh <args>
 ```
 ```
 
 - The `description` field appears in the system prompt — keep it concise and action-oriented.
-- Use project-root-relative paths in documentation (e.g., `skills/skill-name/script.sh`).
+- Use project-root-relative paths in documentation (e.g., `skills/library/skill-name/script.sh`).
 
 ### Skill Structure
 
@@ -69,7 +69,7 @@ If a skill needs an API key, add it via the admin UI (Settings > Agent Jobs > Se
 
 ```bash
 # Activate
-ln -s ../skill-name skills/active/skill-name
+ln -s ../library/skill-name skills/active/skill-name
 
 # Deactivate
 rm skills/active/skill-name
@@ -84,10 +84,10 @@ The `skills/active/` directory is shared by both agent backends via symlink brid
 ### Simple bash skill (most common)
 
 ```bash
-mkdir skills/my-skill
+mkdir skills/library/my-skill
 ```
 
-**skills/my-skill/SKILL.md:**
+**skills/library/my-skill/SKILL.md:**
 ```markdown
 ---
 name: my-skill
@@ -101,11 +101,11 @@ Requires MY_API_KEY environment variable.
 
 ## Usage
 ```bash
-skills/my-skill/run.sh <args>
+skills/library/my-skill/run.sh <args>
 ```
 ```
 
-**skills/my-skill/run.sh:**
+**skills/library/my-skill/run.sh:**
 ```bash
 #!/bin/bash
 set -euo pipefail
@@ -117,8 +117,8 @@ if [ -z "$MY_API_KEY" ]; then echo "Error: MY_API_KEY not set"; exit 1; fi
 
 Then make it executable and activate:
 ```bash
-chmod +x skills/my-skill/run.sh
-ln -s ../my-skill skills/active/my-skill
+chmod +x skills/library/my-skill/run.sh
+ln -s ../library/my-skill skills/active/my-skill
 ```
 
 ### Node.js skill
@@ -131,4 +131,4 @@ Always build AND test a skill in the same job. Tell the agent to test with real
 
 ## Default Skills
 
-Check `skills/` for available built-in skills. Activate any you need by symlinking into `skills/active/`.
+Check `skills/library/` for available built-in skills. Activate any you need by symlinking into `skills/active/`.

package/templates/skills/{agent-job-secrets → library/agent-job-secrets}/SKILL.md

@@ -7,10 +7,10 @@ description: List and retrieve agent secrets. Plain secrets are also available a
 
 ```bash
 # List available secret keys (fetches current list from server)
-node skills/agent-job-secrets/agent-job-secrets.js
+node skills/library/agent-job-secrets/agent-job-secrets.js
 
 # Get a secret value (OAuth credentials are auto-refreshed)
-node skills/agent-job-secrets/agent-job-secrets.js get MY_CREDENTIALS
+node skills/library/agent-job-secrets/agent-job-secrets.js get MY_CREDENTIALS
 ```
 
 ## Notes