Reference for ClawNet CLI internals, architecture, and recent changes. Use this skill when working on clawnet, clawnet-paperclip-plugin, or any code that interacts with the ClawNet registry, vault, ORDFS content fetching, or agent/organization publishing.
From bopen-toolsnpx claudepluginhub b-open-io/claude-plugins --plugin bopen-toolsThis skill uses the workspace's default tool permissions.
Searches, retrieves, and installs Agent Skills from prompts.chat registry using MCP tools like search_skills and get_skill. Activates for finding skills, browsing catalogs, or extending Claude.
Searches prompts.chat for AI prompt templates by keyword or category, retrieves by ID with variable handling, and improves prompts via AI. Use for discovering or enhancing prompts.
Compares coding agents like Claude Code and Aider on custom YAML-defined codebase tasks using git worktrees, measuring pass rate, cost, time, and consistency.
ClawNet CLI uses @1sat/vault@0.0.6 and @1sat/wallet-mac for key management. The old configureVault() helper and built-in se-helper binary have been removed.
The vault is composed from three pieces:
SecureEnclaveProvider from @1sat/wallet-mac — platform-specific Secure Enclave operations. Instantiated with SecureEnclaveProvider({ name: "ClawNet" }).FileVaultStorage from @1sat/vault — file-based vault entry storage.createVault(provider, storage) from @1sat/vault — creates the vault instance from a provider and storage backend.import { SecureEnclaveProvider } from "@1sat/wallet-mac";
import { FileVaultStorage, createVault } from "@1sat/vault";
const provider = new SecureEnclaveProvider({ name: "ClawNet" });
const storage = new FileVaultStorage();
const vault = createVault(provider, storage);
clawnet add fetches files via /content/{manifest}/{path} directory paths. ORDFS resolves _N refs and nested directories natively, so the CLI no longer needs to parse them manually. The old downloadDirectoryEntries function with manual _N parsing was removed.
Example fetch path:
https://ordfs.network/content/{manifestTxid}/src/index.ts
ORDFS handles the directory tree resolution server-side.
clawnet publish ORGANIZATION.md publishes organization packages with an agent hierarchy (roles, reporting structure).
The ORGANIZATION.md format uses YAML frontmatter with an agents: array:
---
name: my-org
agents:
- slug: lead-agent
role: lead
- slug: worker-agent
role: worker
reportsTo: lead-agent
---
Each agent entry supports:
slug — agent identifier (must match a published agent)role — the agent's role within the organizationreportsTo — slug of the agent this one reports to (establishes hierarchy)Agent .md files support an icon: field in YAML frontmatter. The icon URL points to an avatar image that is stored in the registry and served via the API.
---
name: my-agent
icon: https://example.com/avatar.png
---