tools-manager 0.1.0

package/docs/images/menu.svg

@@ -0,0 +1,85 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1164" height="812" viewBox="0 0 1164 812">
+  <rect width="1164" height="812" fill="#e9edf5"/>
+  <style>
+    .mono{font-family:"SFMono-Regular","Menlo","Consolas",monospace}
+    .muted{fill:#5f6268}
+    .amber{fill:#9b6100}
+    .green{fill:#466100}
+    .prompt{fill:#15803d;font-weight:700}
+    .cmd{fill:#6b66d8;font-weight:700}
+  </style>
+  <text x="10" y="13" class="mono prompt" font-size="18">➜ tm</text>
+
+  <rect x="16" y="27" width="791" height="64" rx="5" fill="none" stroke="#a7adb8" stroke-width="1.5"/>
+  <text x="31" y="55" class="mono green" font-size="18">Tools Manager</text>
+  <text x="31" y="76" class="mono muted" font-size="18">One local control plane for skills, presets, and MCP servers.</text>
+  <text x="11" y="139" class="mono muted" font-size="18">↑/↓ choose  Enter run  Esc/q quit</text>
+
+  <text x="11" y="202" class="mono amber" font-size="18">SYSTEM</text>
+  <rect x="11" y="207" width="809" height="20" fill="#caff44"/>
+  <text x="13" y="223" class="mono" font-size="18" fill="#111">› Status</text>
+  <text x="281" y="223" class="mono" font-size="18" fill="#111">Paths, counts, and detected agents.</text>
+  <text x="732" y="223" class="mono cmd" font-size="18">tm status</text>
+
+  <text x="11" y="265" class="mono amber" font-size="18">AGENTS</text>
+  <text x="31" y="286" class="mono muted" font-size="18">List agent contents</text>
+  <text x="281" y="286" class="mono muted" font-size="18">Show skills and MCP per agent.</text>
+  <text x="732" y="286" class="mono muted" font-size="18">tm agents list --tool</text>
+
+  <text x="11" y="328" class="mono amber" font-size="18">SKILLS</text>
+  <text x="31" y="349" class="mono muted" font-size="18">Add skill from source</text>
+  <text x="281" y="349" class="mono muted" font-size="18">Import a local path or Git URL.</text>
+  <text x="732" y="349" class="mono muted" font-size="18">tm skills add</text>
+  <text x="31" y="370" class="mono muted" font-size="18">Import agent skills</text>
+  <text x="281" y="370" class="mono muted" font-size="18">Choose an agent, defaulting to all.</text>
+  <text x="732" y="370" class="mono muted" font-size="18">tm skills add --tool</text>
+  <text x="31" y="391" class="mono muted" font-size="18">List skills</text>
+  <text x="281" y="391" class="mono muted" font-size="18">Browse the managed skill registry.</text>
+  <text x="732" y="391" class="mono muted" font-size="18">tm skills list</text>
+  <text x="31" y="412" class="mono muted" font-size="18">Show skill</text>
+  <text x="281" y="412" class="mono muted" font-size="18">Inspect one skill document.</text>
+  <text x="732" y="412" class="mono muted" font-size="18">tm skills show</text>
+  <text x="31" y="433" class="mono muted" font-size="18">Remove skill</text>
+  <text x="281" y="433" class="mono muted" font-size="18">Delete managed source and agent symlinks.</text>
+  <text x="732" y="433" class="mono muted" font-size="18">tm skills remove</text>
+  <text x="31" y="454" class="mono muted" font-size="18">Sync skills</text>
+  <text x="281" y="454" class="mono muted" font-size="18">Apply a preset to agents.</text>
+  <text x="732" y="454" class="mono muted" font-size="18">tm skills sync --tool</text>
+
+  <text x="11" y="496" class="mono amber" font-size="18">SKILL PRESETS</text>
+  <text x="31" y="517" class="mono muted" font-size="18">List skill presets</text>
+  <text x="281" y="517" class="mono muted" font-size="18">Show skill groups.</text>
+  <text x="732" y="517" class="mono muted" font-size="18">tm presets list</text>
+  <text x="31" y="538" class="mono muted" font-size="18">Move skill preset</text>
+  <text x="281" y="538" class="mono muted" font-size="18">Move membership between skill presets.</text>
+  <text x="732" y="538" class="mono muted" font-size="18">tm presets move</text>
+
+  <text x="11" y="580" class="mono amber" font-size="18">MCP</text>
+  <text x="31" y="601" class="mono muted" font-size="18">Add MCP server</text>
+  <text x="281" y="601" class="mono muted" font-size="18">Register command, args, env, and tools.</text>
+  <text x="732" y="601" class="mono muted" font-size="18">tm mcp add --command --arg --env --tool</text>
+  <text x="31" y="622" class="mono muted" font-size="18">Import MCP from agents</text>
+  <text x="281" y="622" class="mono muted" font-size="18">Choose an agent, defaulting to all.</text>
+  <text x="732" y="622" class="mono muted" font-size="18">tm mcp add --tool</text>
+  <text x="31" y="643" class="mono muted" font-size="18">List MCP servers</text>
+  <text x="281" y="643" class="mono muted" font-size="18">Browse the managed MCP registry.</text>
+  <text x="732" y="643" class="mono muted" font-size="18">tm mcp list</text>
+  <text x="31" y="664" class="mono muted" font-size="18">Show MCP server</text>
+  <text x="281" y="664" class="mono muted" font-size="18">Inspect one MCP server.</text>
+  <text x="732" y="664" class="mono muted" font-size="18">tm mcp show</text>
+  <text x="31" y="685" class="mono muted" font-size="18">Remove MCP server</text>
+  <text x="281" y="685" class="mono muted" font-size="18">Delete from tm; sync to update agents.</text>
+  <text x="732" y="685" class="mono muted" font-size="18">tm mcp remove</text>
+  <text x="31" y="706" class="mono muted" font-size="18">Sync MCP</text>
+  <text x="281" y="706" class="mono muted" font-size="18">Write tm MCP registry to agents.</text>
+  <text x="732" y="706" class="mono muted" font-size="18">tm mcp sync</text>
+
+  <text x="11" y="748" class="mono amber" font-size="18">SYSTEM</text>
+  <text x="31" y="769" class="mono muted" font-size="18">Backup skills</text>
+  <text x="281" y="769" class="mono muted" font-size="18">Commit managed skills with Git.</text>
+  <text x="732" y="769" class="mono muted" font-size="18">tm backup</text>
+  <text x="31" y="790" class="mono muted" font-size="18">Help</text>
+  <text x="281" y="790" class="mono muted" font-size="18">Print command reference.</text>
+  <text x="732" y="790" class="mono muted" font-size="18">tm --help</text>
+  <rect x="11" y="794" width="10" height="18" fill="#ff7f5a"/>
+</svg>

package/docs/images/workflow.svg

@@ -0,0 +1,70 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1100" height="620" viewBox="0 0 1100 620">
+  <rect width="1100" height="620" fill="#10110e"/>
+  <style>
+    .title{font-family:"SFMono-Regular","Menlo","Consolas",monospace;font-size:34px;font-weight:700;fill:#f3efd8}
+    .label{font-family:"SFMono-Regular","Menlo","Consolas",monospace;font-size:18px;font-weight:700;fill:#f3efd8}
+    .text{font-family:"SFMono-Regular","Menlo","Consolas",monospace;font-size:14px;fill:#a7aa98}
+    .cmd{font-family:"SFMono-Regular","Menlo","Consolas",monospace;font-size:13px;fill:#d7ff63}
+    .box{fill:#181a16;stroke:#34382d;stroke-width:2;rx:10}
+    .accent{stroke:#d7ff63;stroke-width:2.4;fill:none;marker-end:url(#arrow)}
+    .soft{stroke:#7fc7ff;stroke-width:2;fill:none;marker-end:url(#arrowBlue)}
+  </style>
+  <defs>
+    <marker id="arrow" markerWidth="10" markerHeight="10" refX="8" refY="3" orient="auto">
+      <path d="M0,0 L0,6 L9,3 z" fill="#d7ff63"/>
+    </marker>
+    <marker id="arrowBlue" markerWidth="10" markerHeight="10" refX="8" refY="3" orient="auto">
+      <path d="M0,0 L0,6 L9,3 z" fill="#7fc7ff"/>
+    </marker>
+  </defs>
+
+  <text x="42" y="58" class="title">Tools Manager Workflow</text>
+  <text x="44" y="86" class="text">One local source of truth for skills, skill presets, and MCP configuration.</text>
+
+  <rect class="box" x="42" y="135" width="250" height="130"/>
+  <text x="66" y="168" class="label">Local Agents</text>
+  <text x="66" y="196" class="text">~/.codex/skills</text>
+  <text x="66" y="218" class="text">~/.cursor/skills</text>
+  <text x="66" y="240" class="text">~/.claude/skills</text>
+
+  <rect class="box" x="425" y="125" width="260" height="150"/>
+  <text x="449" y="158" class="label">Tools Manager</text>
+  <text x="449" y="187" class="text">~/.tools-manager/skills</text>
+  <text x="449" y="209" class="text">tools-manager.db</text>
+  <text x="449" y="231" class="text">config.toml</text>
+  <text x="449" y="254" class="cmd">tm skills add --tool all</text>
+
+  <rect class="box" x="808" y="135" width="250" height="130"/>
+  <text x="832" y="168" class="label">Skill Sync</text>
+  <text x="832" y="197" class="text">Default / Work presets</text>
+  <text x="832" y="219" class="text">agent skill directories</text>
+  <text x="832" y="246" class="cmd">tm skills sync</text>
+
+  <path class="accent" d="M292 200 C345 200 365 200 424 200"/>
+  <path class="accent" d="M686 200 C740 200 760 200 807 200"/>
+
+  <rect class="box" x="42" y="365" width="250" height="130"/>
+  <text x="66" y="398" class="label">Agent MCP Config</text>
+  <text x="66" y="426" class="text">~/.codex/config.toml</text>
+  <text x="66" y="448" class="text">~/.cursor/mcp.json</text>
+  <text x="66" y="470" class="text">~/.claude/mcp.json</text>
+
+  <rect class="box" x="425" y="355" width="260" height="150"/>
+  <text x="449" y="388" class="label">MCP Registry</text>
+  <text x="449" y="417" class="text">name / command / args</text>
+  <text x="449" y="439" class="text">env / target tools</text>
+  <text x="449" y="462" class="cmd">tm mcp add --tool all</text>
+  <text x="449" y="484" class="cmd">tm mcp list</text>
+
+  <rect class="box" x="808" y="365" width="250" height="130"/>
+  <text x="832" y="398" class="label">Config Sync</text>
+  <text x="832" y="427" class="text">writes TOML / JSON</text>
+  <text x="832" y="449" class="text">creates timestamp backups</text>
+  <text x="832" y="476" class="cmd">tm mcp sync</text>
+
+  <path class="soft" d="M292 430 C345 430 365 430 424 430"/>
+  <path class="soft" d="M686 430 C740 430 760 430 807 430"/>
+
+  <text x="440" y="565" class="cmd">tm</text>
+  <text x="474" y="565" class="text">opens the interactive command menu for all of these flows.</text>
+</svg>

package/docs/remote-skill-repositories.md

@@ -0,0 +1,99 @@
+# Remote Skill Repositories
+
+Remote skill repositories are Git repositories that contain one or more skill directories. Each skill directory must include a `SKILL.md` or `skill.md` file.
+
+## Single Skill Repository
+
+Use this layout when the repository only contains one skill:
+
+```text
+my-skill-repo/
+  SKILL.md
+  scripts/
+  references/
+```
+
+Import it with:
+
+```bash
+tm skills add 'git@github.com:you/my-skill-repo.git'
+```
+
+## Multiple Skills Repository
+
+Use this layout when one repository contains multiple skills:
+
+```text
+my-skills-repo/
+  skill-a/
+    SKILL.md
+  skill-b/
+    SKILL.md
+  skill-c/
+    SKILL.md
+```
+
+Import all skills under the shared directory:
+
+```bash
+tm skills add 'git@github.com:you/my-skills-repo.git#main:skills'
+```
+
+Or import a specific skill by providing the branch, tag, or commit and the skill subpath:
+
+```bash
+tm skills add 'git@github.com:you/my-skills-repo.git#main:skill-a'
+```
+
+The Git source format is:
+
+```text
+<git-url>#<branch-or-tag-or-commit>:<skill-subpath>
+```
+
+Examples:
+
+```bash
+tm skills add 'git@gitlab.company.com:group/skills.git#main:cb-yapi-content'
+tm skills add 'https://github.com/you/skills.git#v1.0.0:frontend-skill'
+```
+
+## Private Repositories
+
+Tools Manager shells out to your local `git clone`. It does not prompt for, store, or refresh Git credentials.
+
+Before importing a private repository, make sure this works in your terminal:
+
+```bash
+git clone <repo-url>
+```
+
+For HTTPS GitLab repositories, use a personal access token instead of your password when the account has 2FA enabled. For SSH repositories, use the SSH form after your key is configured:
+
+```bash
+tm skills add 'git@gitlab.company.com:group/skills.git#main:skills'
+```
+
+## Skill Metadata
+
+`SKILL.md` should include frontmatter with a name and description:
+
+```md
+---
+name: My Skill
+description: What this skill does
+---
+
+# My Skill
+
+Instructions...
+```
+
+The imported skill name is generated from the `name` field. If `name` is missing, Tools Manager uses the skill directory name.
+
+## Notes
+
+- If a source contains multiple skill directories, all discovered skills are imported.
+- Existing skills with the same name are updated.
+- Git authentication is delegated to your local Git setup, including SSH keys, VPN, credential helpers, and tokens.
+- Files next to `SKILL.md`, such as `scripts/`, `references/`, and `assets/`, are copied into the managed skill directory.

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "tools-manager",
+  "version": "0.1.0",
+  "description": "A Bun CLI for managing AI agent skills and MCP server configuration across tools.",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "tm": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "docs",
+    "SKILL.md",
+    "README.md",
+    "README.zh-CN.md",
+    "package.json"
+  ],
+  "scripts": {
+    "tm": "bun run src/cli.ts",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit",
+    "build": "rm -rf dist && bun run typecheck && bun build --target=bun --outfile=dist/cli.js ./src/cli.ts",
+    "check": "bun run typecheck && bun test",
+    "pack:dry": "npm pack --dry-run",
+    "prepack": "bun run build",
+    "prepublishOnly": "bun run check",
+    "release:dry": "bun run check && npm pack --dry-run",
+    "release": "bun run check && npm publish",
+    "release:patch": "bun run check && npm version patch && npm publish",
+    "release:minor": "bun run check && npm version minor && npm publish",
+    "release:major": "bun run check && npm version major && npm publish"
+  },
+  "engines": {
+    "bun": ">=1.3.0"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^5.9.3"
+  }
+}