fold-agent 0.1.0

package/skills/fold/SKILL.md

@@ -0,0 +1,81 @@
+---
+name: fold
+description: Work safely in encrypted Fold Markdown project rooms. Use when joining or resuming a Fold room from an agent handoff, handling fold:v1 tokens or room URLs, exporting project context, replying to Fold comments/requests, or submitting reviewable Markdown proposals through the Fold CLI.
+---
+
+# Fold
+
+Fold is an encrypted Markdown project room for humans and coding agents. Use the
+Fold CLI for room work. Treat this skill as reusable operating policy; live
+project memory comes from encrypted room replay through `fold-agent bootstrap`,
+`fold-agent resume`, or `fold-agent context`, not from the skill.
+
+## Start Here
+
+When a handoff contains a pinned `fold-agent bootstrap` command, run that first:
+
+```bash
+npx --yes fold-agent@0.1.0 bootstrap --room "fold:v1:..." --alias "launch" --output ./fold-project --json
+```
+
+If `fold` is not globally installed but you are inside the Fold repo, use the
+repo-local wrapper from the handoff:
+
+```bash
+npm run --silent cli -- bootstrap --room "fold:v1:..." --alias "launch" --output ./fold-project --json
+```
+
+Do not use `/usr/bin/fold`. That is the Unix text-wrapping command, not Fold.
+The Fold skill teaches agent behavior; `fold-agent` performs encrypted room
+operations.
+
+If `fold-agent resume` is unavailable, use the fallback sequence in
+`references/workflow.md`.
+
+## Rules
+
+- Keep room URLs, `fold:v1:` tokens, `#key` fragments, and `.fold/rooms.json`
+  secret.
+- Never paste room keys, tokens, or decrypted access files into logs, issues,
+  pull requests, or third-party services.
+- Use `fold-agent post` for fresh Markdown files. Use proposals for changes to
+  existing accepted files unless the room policy explicitly asks for direct
+  edits.
+- Do not self-assign a visible persona. Fold assigns agent personas from
+  room/system logic.
+- Use saved aliases after the first join. Repeat agents should not reinstall
+  this skill every time.
+
+## Normal Workflow
+
+1. Resume the room.
+2. Read open requests, comments, and pending proposals from the resume output.
+3. Edit exported files locally.
+4. Post fresh Markdown files directly:
+
+```bash
+fold-agent post ./fold-project/NEW_FILE.md --room "launch" --path "NEW_FILE.md" --json
+```
+
+5. Submit existing-file changes as one reviewable proposal:
+
+```bash
+fold-agent propose ./fold-project \
+  --room "launch" \
+  --title "Describe the change" \
+  --comment "Summarize what changed." \
+  --json
+```
+
+6. Reply instead of proposing when a human request needs clarification:
+
+```bash
+fold-agent reply "<thread-id>" --room "launch" --text "Short reply." --json
+```
+
+## References
+
+- Read `references/security.md` before handling secret-bearing room access.
+- Read `references/workflow.md` when `fold-agent resume` is unavailable or a handoff
+  gives only older commands.
+- Read `references/cli.md` for command examples and repeat-agent behavior.

package/skills/fold/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Fold"
+  short_description: "Bootstrap encrypted Fold project rooms"
+  default_prompt: "Use $fold to bootstrap a Fold project room from an agent handoff."

package/skills/fold/references/cli.md

@@ -0,0 +1,33 @@
+# Fold CLI Reference
+
+Development wrapper inside the Fold repo:
+
+```bash
+npm run --silent cli -- <command>
+```
+
+Do not use `/usr/bin/fold`. That is the Unix text-wrapping command, not Fold.
+
+Primary fresh-agent command:
+
+```bash
+npx --yes fold-agent@0.1.0 bootstrap --room "fold:v1:..." --alias "launch" --output ./fold-project --json
+```
+
+Installed CLI repeat command:
+
+```bash
+fold-agent resume --room "launch" --output ./fold-project --json
+```
+
+Bundled skill commands:
+
+```bash
+fold-agent skill
+fold-agent skill status
+fold-agent skill update
+```
+
+Do not use `npm install -g fold` or `npx fold`; the public unscoped npm package
+name is not Fold's CLI package. Use the pinned `fold-agent` package-runner
+command from the handoff.

package/skills/fold/references/security.md

@@ -0,0 +1,14 @@
+# Fold Security
+
+- Treat `fold:v1:` tokens, room URLs with `#key`, copied agent handoffs, and
+  `.fold/rooms.json` as decryption-capable secrets.
+- The room key belongs client-side. Never send URL fragments or room secrets to
+  server APIs.
+- Routine JSON output should stay redacted. If command output contains
+  `fold:v1:`, `#key=`, or `roomSecret`, handle it as secret-bearing invite or
+  profile output.
+- The server may see plaintext routing metadata such as `roomId`, sequence, and
+  sender id. Markdown bodies, comments, proposals, and timeline payloads are
+  decrypted client-side.
+- Losing the room key means losing access unless someone still has a saved
+  alias, token, room URL, or export.

package/skills/fold/references/workflow.md

@@ -0,0 +1,48 @@
+# Fold Workflow
+
+Use this fallback when `fold-agent bootstrap` is not available.
+
+First join:
+
+```bash
+fold-agent room add "fold:v1:..." --alias "launch"
+fold-agent status --room "launch" --json
+fold-agent export --room "launch" --output ./fold-project --json
+fold-agent context --room "launch" --json
+fold-agent requests --room "launch" --json
+fold-agent comments --room "launch" --type comment --open --json
+fold-agent proposals --room "launch" --json
+```
+
+Repeat work in the same project:
+
+```bash
+fold-agent resume --room "launch" --output ./fold-project --json
+```
+
+Post a fresh Markdown file directly:
+
+```bash
+fold-agent post ./fold-project/NEW_FILE.md --room "launch" --path "NEW_FILE.md" --json
+```
+
+Submit changes to existing files as a proposal:
+
+```bash
+fold-agent propose ./fold-project --room "launch" --title "Describe the change" --comment "Summarize what changed." --json
+```
+
+Reply to a human request:
+
+```bash
+fold-agent reply "<thread-id>" --room "launch" --text "Short reply." --json
+```
+
+Review only when explicitly asked:
+
+```bash
+fold-agent proposals --room "launch" --json
+fold-agent show-proposal "<proposal-id>" --room "launch" --json
+fold-agent accept "<proposal-id>" --room "launch" --json
+fold-agent reject "<proposal-id>" --room "launch" --json
+```