konstruct 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 n3sh
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,77 @@
+# Konstruct
+
+Package manager for AI agent skills. Manages the lifecycle of skill directories — discovery, installation, updating, and removal — across one or more AI agent tool directories.
+
+## Install
+
+```bash
+npm install -g konstruct
+```
+
+## Quick Start
+
+```bash
+# Initialize a project
+konstruct init
+
+# Add a skill from GitHub
+konstruct add github:anthropics/skills/skills/canvas-design#main
+
+# Install all skills from skills.json
+konstruct install
+
+# Check for updates
+konstruct update
+
+# List installed skills
+konstruct list
+```
+
+## Commands
+
+| Command | Description |
+|---|---|
+| `konstruct init` | Create `skills.json` and `konstruct.config.json` |
+| `konstruct add <source>` | Add a skill from a git or local source |
+| `konstruct install` | Install all skills from `skills.json` |
+| `konstruct update` | Re-install git skills at their manifest refs |
+| `konstruct remove <names...>` | Remove one or more skills by name |
+| `konstruct list` | List all skills in the current manifest |
+| `konstruct defaults` | View and update default agent preferences |
+
+### Global mode
+
+All commands support `-g, --global` to operate on `~/.konstruct/` instead of the current directory.
+
+```bash
+konstruct init -g          # Set up global config
+konstruct add -g <source>  # Install globally
+konstruct list -g          # List global skills
+```
+
+### Options
+
+- `-g, --global` — Use global `~/.konstruct/` directory
+- `-s, --ssh` — Use SSH for git cloning (default: HTTPS with auto-retry)
+- `--user` — Add as a userSkill (local, never auto-updated)
+- `--path <path>` — Custom installation path
+
+## Source formats
+
+| Format | Example |
+|---|---|
+| GitHub | `github:owner/repo/path#ref` |
+| GitLab | `gitlab:owner/repo#ref` |
+| Generic git | `git:https://host/repo.git#ref` |
+| Local file | `file:./relative/path` |
+| Bare shorthand | `owner/repo` (defaults to GitHub) |
+
+## Supported agents
+
+Konstruct installs skills into the appropriate directory for each agent:
+
+claude, cursor, windsurf, continue, copilot, gemini, augment, cline, goose, junie, kiro, opencode, openhands, roo, trae, kode, qwen-code, codex, amp, kilo, pochi, neovate, mux, zencoder, adal
+
+## License
+
+MIT

package/bin/cli.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+import { fileURLToPath } from 'node:url';
+import { dirname, resolve } from 'node:path';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+// Point to the tsup-bundled output.  Falls back to tsx dev shim if dist/ doesn't exist yet.
+const distEntry = resolve(__dirname, '..', 'dist', 'index.js');
+
+try {
+  // Dynamic import so the path is resolved at runtime
+  await import(distEntry);
+} catch {
+  // dist/ not built yet — fall back to tsx for development
+  const { execFileSync } = await import('node:child_process');
+  const projectRoot = resolve(__dirname, '..');
+  const tsx = resolve(projectRoot, 'node_modules', '.bin', 'tsx');
+  const entrypoint = resolve(projectRoot, 'src', 'cli', 'index.ts');
+  execFileSync(tsx, [entrypoint, ...process.argv.slice(2)], {
+    stdio: 'inherit',
+    env: process.env,
+  });
+}