create-boringos 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 BoringOS Contributors
+
+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/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,94 @@
+#!/usr/bin/env node
+import { mkdirSync, writeFileSync, readFileSync, readdirSync, existsSync, statSync } from "node:fs";
+import { join, dirname, resolve } from "node:path";
+import { execSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+function main() {
+    const args = process.argv.slice(2);
+    const name = args.find((a) => !a.startsWith("--"));
+    const template = args.includes("--template")
+        ? args[args.indexOf("--template") + 1] ?? "minimal"
+        : args.includes("--full") ? "full" : "minimal";
+    if (!name || args.includes("--help") || args.includes("-h")) {
+        console.log(`
+  create-boringos — scaffold a new BoringOS project
+
+  Usage:
+    npx create-boringos <project-name> [options]
+
+  Options:
+    --template <minimal|full>   Template to use (default: minimal)
+    --full                      Shorthand for --template full
+    --help                      Show this help
+
+  Examples:
+    npx create-boringos my-app
+    npx create-boringos my-app --full
+`);
+        process.exit(name ? 0 : 1);
+    }
+    if (template !== "minimal" && template !== "full") {
+        console.error(`Unknown template: ${template}. Use "minimal" or "full".`);
+        process.exit(1);
+    }
+    const projectDir = resolve(process.cwd(), name);
+    if (existsSync(projectDir)) {
+        console.error(`Directory already exists: ${projectDir}`);
+        process.exit(1);
+    }
+    console.log(`\nCreating ${name} with ${template} template...\n`);
+    // Copy template files
+    const templateDir = join(__dirname, "templates", template);
+    copyTemplate(templateDir, projectDir, { name });
+    // Detect package manager
+    const pm = detectPackageManager();
+    // Install dependencies
+    console.log(`Installing dependencies with ${pm}...\n`);
+    try {
+        execSync(`${pm} install`, { cwd: projectDir, stdio: "inherit" });
+    }
+    catch {
+        console.log("\nDependency installation failed. Run it manually:");
+        console.log(`  cd ${name} && ${pm} install`);
+    }
+    console.log(`
+Done! Your BoringOS app is ready.
+
+  cd ${name}
+  ${pm} run dev
+
+Server starts on http://localhost:3000 with embedded Postgres.
+Health check: http://localhost:3000/health
+`);
+}
+function copyTemplate(src, dest, vars) {
+    mkdirSync(dest, { recursive: true });
+    for (const entry of readdirSync(src)) {
+        const srcPath = join(src, entry);
+        const stat = statSync(srcPath);
+        if (stat.isDirectory()) {
+            copyTemplate(srcPath, join(dest, entry), vars);
+        }
+        else {
+            let content = readFileSync(srcPath, "utf8");
+            // Replace template variables
+            for (const [key, value] of Object.entries(vars)) {
+                content = content.replaceAll(`{{${key}}}`, value);
+            }
+            // Remove .tmpl extension
+            const destName = entry.endsWith(".tmpl") ? entry.slice(0, -5) : entry;
+            writeFileSync(join(dest, destName), content);
+        }
+    }
+}
+function detectPackageManager() {
+    const userAgent = process.env.npm_config_user_agent ?? "";
+    if (userAgent.includes("pnpm"))
+        return "pnpm";
+    if (userAgent.includes("yarn"))
+        return "yarn";
+    return "npm";
+}
+main();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACpG,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D,SAAS,IAAI;IACX,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC;QAC1C,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,SAAS;QACnD,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IAEjD,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5D,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;CAcf,CAAC,CAAC;QACC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7B,CAAC;IAED,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;QAClD,OAAO,CAAC,KAAK,CAAC,qBAAqB,QAAQ,4BAA4B,CAAC,CAAC;QACzE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC;IAEhD,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3B,OAAO,CAAC,KAAK,CAAC,6BAA6B,UAAU,EAAE,CAAC,CAAC;QACzD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,SAAS,QAAQ,gBAAgB,CAAC,CAAC;IAEjE,sBAAsB;IACtB,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC3D,YAAY,CAAC,WAAW,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IAEhD,yBAAyB;IACzB,MAAM,EAAE,GAAG,oBAAoB,EAAE,CAAC;IAElC,uBAAuB;IACvB,OAAO,CAAC,GAAG,CAAC,gCAAgC,EAAE,OAAO,CAAC,CAAC;IACvD,IAAI,CAAC;QACH,QAAQ,CAAC,GAAG,EAAE,UAAU,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IACnE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,GAAG,CAAC,oDAAoD,CAAC,CAAC;QAClE,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,OAAO,EAAE,UAAU,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO,CAAC,GAAG,CAAC;;;OAGP,IAAI;IACP,EAAE;;;;CAIL,CAAC,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,GAAW,EAAE,IAAY,EAAE,IAA4B;IAC3E,SAAS,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAErC,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;QACrC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACjC,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;QAE/B,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACvB,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC;QACjD,CAAC;aAAM,CAAC;YACN,IAAI,OAAO,GAAG,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC5C,6BAA6B;YAC7B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBAChD,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,GAAG,IAAI,EAAE,KAAK,CAAC,CAAC;YACpD,CAAC;YACD,yBAAyB;YACzB,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;YACtE,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,oBAAoB;IAC3B,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,EAAE,CAAC;IAC1D,IAAI,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IAC9C,IAAI,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IAC9C,OAAO,KAAK,CAAC;AACf,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/templates/full/.env.example.tmpl

@@ -0,0 +1,23 @@
+# Server
+PORT=3000
+
+# Database (optional — embedded Postgres used if not set)
+# DATABASE_URL=postgres://user:pass@localhost:5432/myapp
+
+# Auth (set in production)
+# AUTH_SECRET=change-me-in-production
+
+# Memory (optional)
+# HEBBS_ENDPOINT=https://api.hebbs.ai
+# HEBBS_API_KEY=your-key
+# HEBBS_WORKSPACE=your-workspace
+
+# Slack connector (optional)
+# SLACK_SIGNING_SECRET=your-signing-secret
+
+# Google connector (optional)
+# GOOGLE_CLIENT_ID=your-client-id
+# GOOGLE_CLIENT_SECRET=your-client-secret
+
+# Redis for BullMQ (optional — in-process queue used if not set)
+# REDIS_URL=redis://localhost:6379

package/dist/templates/full/.gitignore.tmpl

@@ -0,0 +1,5 @@
+node_modules/
+dist/
+.data/
+.env
+*.log

package/dist/templates/full/README.md.tmpl

@@ -0,0 +1,38 @@
+# {{name}}
+
+Built with [BoringOS](https://github.com/boringos/boringos).
+
+## Run
+
+```bash
+cp .env.example .env    # configure your environment
+npm run dev             # starts on http://localhost:3000
+```
+
+## What's included
+
+- Embedded PostgreSQL (zero setup)
+- 6 runtime adapters (Claude, ChatGPT, Gemini, Ollama, command, webhook)
+- 12 persona bundles
+- Workflow engine with branching
+- JWT-authenticated callback API
+- Slack connector (configure SLACK_SIGNING_SECRET)
+- Google Workspace connector (configure GOOGLE_CLIENT_ID)
+- Hebbs memory (configure HEBBS_ENDPOINT)
+- BullMQ queue (configure REDIS_URL)
+- Custom context provider example
+
+## Architecture
+
+```
+src/index.ts    — app configuration and startup
+.env            — environment variables (secrets, API keys)
+.data/          — embedded Postgres data + drive files (gitignored)
+```
+
+## Next steps
+
+1. Create agents and tasks via the callback API
+2. Configure connectors in `.env`
+3. Build custom workflow block handlers
+4. Add more context providers for domain-specific knowledge

package/dist/templates/full/package.json.tmpl

@@ -0,0 +1,23 @@
+{
+  "name": "{{name}}",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "npx tsx src/index.ts",
+    "build": "tsc",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "@boringos/core": "^0.0.1",
+    "@boringos/memory": "^0.0.1",
+    "@boringos/connector-slack": "^0.0.1",
+    "@boringos/connector-google": "^0.0.1",
+    "@boringos/pipeline": "^0.0.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.7.3"
+  }
+}

package/dist/templates/full/src/index.ts.tmpl

@@ -0,0 +1,60 @@
+import { BoringOS, createHebbsMemory } from "@boringos/core";
+import { slack } from "@boringos/connector-slack";
+import { google } from "@boringos/connector-google";
+import { createBullMQQueue } from "@boringos/pipeline";
+import type { ContextProvider } from "@boringos/core";
+
+// ── Custom context provider example ─────────────────────────────────────────
+
+const companyKnowledge: ContextProvider = {
+  name: "company-knowledge",
+  phase: "system",
+  priority: 25,
+  async provide(event) {
+    return `## Company Knowledge\n\nWelcome to {{name}}. Our agents follow these principles:\n- Ship fast, iterate faster\n- Always write tests\n- Document decisions`;
+  },
+};
+
+// ── Build the app ───────────────────────────────────────────────────────────
+
+const app = new BoringOS({
+  // database: { url: process.env.DATABASE_URL! },  // uncomment for external Postgres
+  // auth: { secret: process.env.AUTH_SECRET! },
+});
+
+// Memory — cognitive recall for agents
+if (process.env.HEBBS_ENDPOINT) {
+  app.memory(createHebbsMemory({
+    endpoint: process.env.HEBBS_ENDPOINT,
+    apiKey: process.env.HEBBS_API_KEY!,
+    workspace: process.env.HEBBS_WORKSPACE,
+  }));
+}
+
+// Connectors — external service integrations
+if (process.env.SLACK_SIGNING_SECRET) {
+  app.connector(slack({ signingSecret: process.env.SLACK_SIGNING_SECRET }));
+}
+
+if (process.env.GOOGLE_CLIENT_ID) {
+  app.connector(google({
+    clientId: process.env.GOOGLE_CLIENT_ID,
+    clientSecret: process.env.GOOGLE_CLIENT_SECRET!,
+  }));
+}
+
+// Queue — opt-in BullMQ for production
+if (process.env.REDIS_URL) {
+  app.queue(createBullMQQueue({ redis: process.env.REDIS_URL }));
+}
+
+// Custom context
+app.contextProvider(companyKnowledge);
+
+// ── Start ───────────────────────────────────────────────────────────────────
+
+const server = await app.listen(Number(process.env.PORT) || 3000);
+
+console.log(`{{name}} running at ${server.url}`);
+console.log(`Health: ${server.url}/health`);
+console.log(`Connectors: ${server.url}/api/connectors/connectors`);

package/dist/templates/full/tsconfig.json.tmpl

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2022"],
+    "strict": true,
+    "skipLibCheck": true,
+    "declaration": true,
+    "outDir": "dist",
+    "rootDir": "src",
+    "esModuleInterop": true
+  },
+  "include": ["src"]
+}

package/dist/templates/minimal/.env.example.tmpl

@@ -0,0 +1,10 @@
+# Database (optional — embedded Postgres used if not set)
+# DATABASE_URL=postgres://user:pass@localhost:5432/myapp
+
+# Memory (optional)
+# HEBBS_ENDPOINT=https://api.hebbs.ai
+# HEBBS_API_KEY=your-key
+# HEBBS_WORKSPACE=your-workspace
+
+# Auth (set in production)
+# AUTH_SECRET=change-me-in-production

package/dist/templates/minimal/.gitignore.tmpl

@@ -0,0 +1,5 @@
+node_modules/
+dist/
+.data/
+.env
+*.log

package/dist/templates/minimal/README.md.tmpl

@@ -0,0 +1,26 @@
+# {{name}}
+
+Built with [BoringOS](https://github.com/boringos/boringos).
+
+## Run
+
+```bash
+npm run dev
+```
+
+Server starts on http://localhost:3000 with embedded Postgres.
+
+## What's included
+
+- Embedded PostgreSQL (zero setup)
+- 6 runtime adapters (Claude, ChatGPT, Gemini, Ollama, command, webhook)
+- 12 persona bundles
+- JWT-authenticated callback API
+- Workflow engine
+
+## Next steps
+
+- Add agents and tasks via the callback API
+- Configure memory: `app.memory(createHebbsMemory({...}))`
+- Add connectors: `app.connector(slack({...}))`
+- Build custom workflows

package/dist/templates/minimal/package.json.tmpl

@@ -0,0 +1,19 @@
+{
+  "name": "{{name}}",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "npx tsx src/index.ts",
+    "build": "tsc",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "@boringos/core": "^0.0.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.7.3"
+  }
+}

package/dist/templates/minimal/src/index.ts.tmpl

@@ -0,0 +1,14 @@
+import { BoringOS } from "@boringos/core";
+
+const app = new BoringOS({
+  // database: { url: "postgres://..." },  // uncomment for external Postgres
+  // auth: { secret: "your-secret" },      // set in production
+});
+
+// app.memory(createHebbsMemory({ endpoint: "...", apiKey: "..." }));
+// app.connector(slack({ signingSecret: "..." }));
+
+const server = await app.listen(3000);
+
+console.log(`{{name}} running at ${server.url}`);
+console.log(`Health: ${server.url}/health`);

package/dist/templates/minimal/tsconfig.json.tmpl

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2022"],
+    "strict": true,
+    "skipLibCheck": true,
+    "declaration": true,
+    "outDir": "dist",
+    "rootDir": "src",
+    "esModuleInterop": true
+  },
+  "include": ["src"]
+}

package/dist/templates/templates/full/.env.example.tmpl

@@ -0,0 +1,23 @@
+# Server
+PORT=3000
+
+# Database (optional — embedded Postgres used if not set)
+# DATABASE_URL=postgres://user:pass@localhost:5432/myapp
+
+# Auth (set in production)
+# AUTH_SECRET=change-me-in-production
+
+# Memory (optional)
+# HEBBS_ENDPOINT=https://api.hebbs.ai
+# HEBBS_API_KEY=your-key
+# HEBBS_WORKSPACE=your-workspace
+
+# Slack connector (optional)
+# SLACK_SIGNING_SECRET=your-signing-secret
+
+# Google connector (optional)
+# GOOGLE_CLIENT_ID=your-client-id
+# GOOGLE_CLIENT_SECRET=your-client-secret
+
+# Redis for BullMQ (optional — in-process queue used if not set)
+# REDIS_URL=redis://localhost:6379

package/dist/templates/templates/full/.gitignore.tmpl

@@ -0,0 +1,5 @@
+node_modules/
+dist/
+.data/
+.env
+*.log

package/dist/templates/templates/full/README.md.tmpl

@@ -0,0 +1,38 @@
+# {{name}}
+
+Built with [BoringOS](https://github.com/boringos/boringos).
+
+## Run
+
+```bash
+cp .env.example .env    # configure your environment
+npm run dev             # starts on http://localhost:3000
+```
+
+## What's included
+
+- Embedded PostgreSQL (zero setup)
+- 6 runtime adapters (Claude, ChatGPT, Gemini, Ollama, command, webhook)
+- 12 persona bundles
+- Workflow engine with branching
+- JWT-authenticated callback API
+- Slack connector (configure SLACK_SIGNING_SECRET)
+- Google Workspace connector (configure GOOGLE_CLIENT_ID)
+- Hebbs memory (configure HEBBS_ENDPOINT)
+- BullMQ queue (configure REDIS_URL)
+- Custom context provider example
+
+## Architecture
+
+```
+src/index.ts    — app configuration and startup
+.env            — environment variables (secrets, API keys)
+.data/          — embedded Postgres data + drive files (gitignored)
+```
+
+## Next steps
+
+1. Create agents and tasks via the callback API
+2. Configure connectors in `.env`
+3. Build custom workflow block handlers
+4. Add more context providers for domain-specific knowledge

package/dist/templates/templates/full/package.json.tmpl

@@ -0,0 +1,23 @@
+{
+  "name": "{{name}}",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "npx tsx src/index.ts",
+    "build": "tsc",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "@boringos/core": "^0.0.1",
+    "@boringos/memory": "^0.0.1",
+    "@boringos/connector-slack": "^0.0.1",
+    "@boringos/connector-google": "^0.0.1",
+    "@boringos/pipeline": "^0.0.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.7.3"
+  }
+}

package/dist/templates/templates/full/src/index.ts.tmpl

@@ -0,0 +1,60 @@
+import { BoringOS, createHebbsMemory } from "@boringos/core";
+import { slack } from "@boringos/connector-slack";
+import { google } from "@boringos/connector-google";
+import { createBullMQQueue } from "@boringos/pipeline";
+import type { ContextProvider } from "@boringos/core";
+
+// ── Custom context provider example ─────────────────────────────────────────
+
+const companyKnowledge: ContextProvider = {
+  name: "company-knowledge",
+  phase: "system",
+  priority: 25,
+  async provide(event) {
+    return `## Company Knowledge\n\nWelcome to {{name}}. Our agents follow these principles:\n- Ship fast, iterate faster\n- Always write tests\n- Document decisions`;
+  },
+};
+
+// ── Build the app ───────────────────────────────────────────────────────────
+
+const app = new BoringOS({
+  // database: { url: process.env.DATABASE_URL! },  // uncomment for external Postgres
+  // auth: { secret: process.env.AUTH_SECRET! },
+});
+
+// Memory — cognitive recall for agents
+if (process.env.HEBBS_ENDPOINT) {
+  app.memory(createHebbsMemory({
+    endpoint: process.env.HEBBS_ENDPOINT,
+    apiKey: process.env.HEBBS_API_KEY!,
+    workspace: process.env.HEBBS_WORKSPACE,
+  }));
+}
+
+// Connectors — external service integrations
+if (process.env.SLACK_SIGNING_SECRET) {
+  app.connector(slack({ signingSecret: process.env.SLACK_SIGNING_SECRET }));
+}
+
+if (process.env.GOOGLE_CLIENT_ID) {
+  app.connector(google({
+    clientId: process.env.GOOGLE_CLIENT_ID,
+    clientSecret: process.env.GOOGLE_CLIENT_SECRET!,
+  }));
+}
+
+// Queue — opt-in BullMQ for production
+if (process.env.REDIS_URL) {
+  app.queue(createBullMQQueue({ redis: process.env.REDIS_URL }));
+}
+
+// Custom context
+app.contextProvider(companyKnowledge);
+
+// ── Start ───────────────────────────────────────────────────────────────────
+
+const server = await app.listen(Number(process.env.PORT) || 3000);
+
+console.log(`{{name}} running at ${server.url}`);
+console.log(`Health: ${server.url}/health`);
+console.log(`Connectors: ${server.url}/api/connectors/connectors`);

package/dist/templates/templates/full/tsconfig.json.tmpl

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2022"],
+    "strict": true,
+    "skipLibCheck": true,
+    "declaration": true,
+    "outDir": "dist",
+    "rootDir": "src",
+    "esModuleInterop": true
+  },
+  "include": ["src"]
+}

package/dist/templates/templates/minimal/.env.example.tmpl

@@ -0,0 +1,10 @@
+# Database (optional — embedded Postgres used if not set)
+# DATABASE_URL=postgres://user:pass@localhost:5432/myapp
+
+# Memory (optional)
+# HEBBS_ENDPOINT=https://api.hebbs.ai
+# HEBBS_API_KEY=your-key
+# HEBBS_WORKSPACE=your-workspace
+
+# Auth (set in production)
+# AUTH_SECRET=change-me-in-production

package/dist/templates/templates/minimal/.gitignore.tmpl

@@ -0,0 +1,5 @@
+node_modules/
+dist/
+.data/
+.env
+*.log

package/dist/templates/templates/minimal/README.md.tmpl

@@ -0,0 +1,26 @@
+# {{name}}
+
+Built with [BoringOS](https://github.com/boringos/boringos).
+
+## Run
+
+```bash
+npm run dev
+```
+
+Server starts on http://localhost:3000 with embedded Postgres.
+
+## What's included
+
+- Embedded PostgreSQL (zero setup)
+- 6 runtime adapters (Claude, ChatGPT, Gemini, Ollama, command, webhook)
+- 12 persona bundles
+- JWT-authenticated callback API
+- Workflow engine
+
+## Next steps
+
+- Add agents and tasks via the callback API
+- Configure memory: `app.memory(createHebbsMemory({...}))`
+- Add connectors: `app.connector(slack({...}))`
+- Build custom workflows

package/dist/templates/templates/minimal/package.json.tmpl

@@ -0,0 +1,19 @@
+{
+  "name": "{{name}}",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "npx tsx src/index.ts",
+    "build": "tsc",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "@boringos/core": "^0.0.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.7.3"
+  }
+}

package/dist/templates/templates/minimal/src/index.ts.tmpl

@@ -0,0 +1,14 @@
+import { BoringOS } from "@boringos/core";
+
+const app = new BoringOS({
+  // database: { url: "postgres://..." },  // uncomment for external Postgres
+  // auth: { secret: "your-secret" },      // set in production
+});
+
+// app.memory(createHebbsMemory({ endpoint: "...", apiKey: "..." }));
+// app.connector(slack({ signingSecret: "..." }));
+
+const server = await app.listen(3000);
+
+console.log(`{{name}} running at ${server.url}`);
+console.log(`Health: ${server.url}/health`);

package/dist/templates/templates/minimal/tsconfig.json.tmpl

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2022"],
+    "strict": true,
+    "skipLibCheck": true,
+    "declaration": true,
+    "outDir": "dist",
+    "rootDir": "src",
+    "esModuleInterop": true
+  },
+  "include": ["src"]
+}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "create-boringos",
+  "version": "0.1.0",
+  "type": "module",
+  "bin": {
+    "create-boringos": "dist/index.js"
+  },
+  "main": "dist/index.js",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.3"
+  },
+  "description": "Scaffold a new BoringOS project",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/BoringOS-dev/boringos.git"
+  },
+  "homepage": "https://boringos.dev",
+  "author": "BoringOS Contributors",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "boringos",
+    "agentic",
+    "ai-agents",
+    "framework"
+  ],
+  "scripts": {
+    "build": "tsc && cp -r src/templates dist/templates",
+    "typecheck": "tsc --noEmit"
+  }
+}