← Back to Skills Marketplace
austindixson

Overstory Integration

by austindixson · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
384
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install overstory-integration
Description
Integrates overstory Claude Code agent swarm with nanobot orchestrator. Manages agent lifecycle, SQLite mail bridge, and git worktree coordination.
Usage Guidance
This skill appears to do what it claims: it will create and use local SQLite DB files (~/.nanobot/agent_lifecycle.db and workspace/.overstory/mail.db), run the overstory CLI (which spawns tmux sessions), and run git commands that can remove worktrees. Before installing or running: 1) Inspect the full, untruncated source files in the package (the provided mail_bridge snippet was truncated in the listing) to confirm there are no hidden behaviors. 2) Ensure the overstory CLI binary you point to is trusted; this wrapper executes it directly. 3) Back up any important repositories or run in an isolated workspace, since cleanup/remove worktree operations can modify or remove worktrees. 4) If you need to limit risk, run the scripts with non-privileged user accounts or in a container/VM. If you want higher assurance, provide the complete untruncated files so I can re-check for hidden/exfiltration code.
Capability Analysis
Type: OpenClaw Skill Name: overstory-integration Version: 1.0.0 The skill bundle is classified as suspicious due to a path traversal vulnerability in `scripts/overstory_wrapper.py`. The `cleanup_worktree` function constructs a path using `self.workspace / ".overstory" / "worktrees" / agent_name`. If the `agent_name` input is not sanitized and contains path traversal sequences (e.g., `../`), it could allow an attacker to delete arbitrary git worktrees or other directories within the `self.workspace` or its parent directories using the `git worktree remove --force` command. This is a local file system manipulation vulnerability, but it does not demonstrate clear intentional malicious behavior like data exfiltration or backdoor installation.
Capability Assessment
Purpose & Capability
Name/description require managing overstory agents, a mail bridge, and worktrees. The package only asks for the overstory CLI, git, and tmux (declared in SKILL.md and reflected in the wrapper), which are proportionate to the described functionality.
Instruction Scope
SKILL.md and the scripts focus on spawning agents, inspecting logs, managing a local SQLite mail DB, and manipulating git worktrees. The code creates ~/.nanobot and .overstory/mail.db (or workspace/.overstory) and runs subprocesses (overstory, git). This is expected, but the skill will modify repository state (worktree remove) and spawn tmux sessions via the overstory CLI, so run with care in important repos or production hosts.
Install Mechanism
Instruction-only skill with bundled Python scripts; no external installer or remote downloads. No install-time network fetches or URL-based archive extraction are present in the provided material.
Credentials
No required secrets or unrelated environment variables. Optional env vars (OVERSTORY_BIN, OVERSTORY_WORKSPACE) are declared and used by the code.
Persistence & Privilege
Skill is not marked always:true and does not modify other skills or global agent configs. It operates on its own local DBs and workspace paths only.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install overstory-integration
  3. After installation, invoke the skill by name or use /overstory-integration
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of overstory-integration. - Integrates overstory Claude Code agent swarm with nanobot orchestrator. - Provides agent lifecycle management with state tracking in SQLite. - Implements a thread-safe SQLite mail bridge for inter-agent messaging. - Supports git worktree coordination for parallel agent workstreams. - Exposes CLI commands for agent, mail, and worktree operations. - Requires only Python standard library and core system tools (overstory CLI, git, tmux).
Metadata
Slug overstory-integration
Version 1.0.0
License
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Overstory Integration?

Integrates overstory Claude Code agent swarm with nanobot orchestrator. Manages agent lifecycle, SQLite mail bridge, and git worktree coordination. It is an AI Agent Skill for Claude Code / OpenClaw, with 384 downloads so far.

How do I install Overstory Integration?

Run "/install overstory-integration" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Overstory Integration free?

Yes, Overstory Integration is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Overstory Integration support?

Overstory Integration is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Overstory Integration?

It is built and maintained by austindixson (@austindixson); the current version is v1.0.0.

💬 Comments