@blunking/codexlink 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mayk Biletti / BLUN
+
+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,127 @@
+<div align="center">
+
+# CodexLink
+
+**Your agent in your pocket.**
+
+[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![Powered by BLUN](https://img.shields.io/badge/Powered%20by-BLUN-22D3EE.svg)](https://blun.ai)
+
+</div>
+
+CodexLink is the BLUN launcher for one visible CLI session with optional Telegram delivery.
+
+It keeps transport and queueing around the operator, without spinning up a hidden second session.
+
+## Install
+
+From GitHub:
+
+```powershell
+npm install -g github:maykbiletti/codexlink
+```
+
+From npm:
+
+```powershell
+npm install -g @blunking/codexlink
+```
+
+Local development:
+
+```powershell
+cd codexlink
+npm install
+npm link
+```
+
+## Commands
+
+Normal startup:
+
+```powershell
+blun-codex
+```
+
+Alias:
+
+```powershell
+codexlink
+```
+
+Telegram mode:
+
+```powershell
+blun-codex telegram-plugin
+```
+
+Legacy equivalent:
+
+```powershell
+blun-codex --telegram plugin
+```
+
+Status:
+
+```powershell
+blun-codex telegram-status
+```
+
+Doctor:
+
+```powershell
+blun-codex telegram-doctor
+```
+
+Dry run:
+
+```powershell
+blun-codex telegram-plugin --print-only
+```
+
+## What it does
+
+- starts one consistent local CLI runtime
+- writes a launch record into `.codex/runtimes/default/`
+- keeps Telegram queue state under `.codex/channels/telegram-default/`
+- attaches Telegram delivery to the same visible session
+- keeps poller, dispatcher, and reply relay separate from the foreground operator
+
+## What it does not do
+
+- no hidden autonomous answer bot
+- no second shadow session
+- no per-agent internal company presets in the public package
+
+## Public profile
+
+The shipped default profile is intentionally generic:
+
+- display name: `CodexLink`
+- lane: `general`
+- workspace: current directory by default
+- model: inherited from the local host unless explicitly set
+
+If you need custom paths or lane rules, add your own profile JSON next to `profiles/default.json`.
+
+## Telegram plugin folder
+
+The bundled plugin lives under `telegram-plugin/` and contains:
+
+- `.codex-plugin/plugin.json`
+- `.mcp.json`
+- `server.js`
+- sidecars and bridge helpers
+
+## Requirements
+
+- Windows PowerShell
+- Node.js 20+
+- a working local `codex` command in `PATH`
+- a Telegram bot token when Telegram mode is enabled
+
+## Notes
+
+- the package currently targets local Windows operators first
+- the package is installable from GitHub before registry publishing
+- once an npm token is available, the same package can be published without changing the command shape

package/bin/blun-codex.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+
+const { spawnSync } = require("node:child_process");
+const path = require("node:path");
+const process = require("node:process");
+
+const runtimeRoot = path.resolve(__dirname, "..");
+const scriptPath = path.join(runtimeRoot, "blun-codex.ps1");
+const shell = process.platform === "win32" ? "powershell.exe" : "pwsh";
+
+const result = spawnSync(
+  shell,
+  ["-ExecutionPolicy", "Bypass", "-File", scriptPath, ...process.argv.slice(2)],
+  {
+    cwd: process.cwd(),
+    stdio: "inherit",
+    env: process.env
+  }
+);
+
+if (result.error) {
+  console.error(result.error.message);
+  process.exit(1);
+}
+
+process.exit(result.status ?? 0);

package/blun-codex.cmd

@@ -0,0 +1,3 @@
+@echo off
+setlocal
+powershell -ExecutionPolicy Bypass -File "%~dp0blun-codex.ps1" %*

package/blun-codex.ps1

@@ -0,0 +1,110 @@
+$ErrorActionPreference = "Stop"
+
+$runtimeRoot = Split-Path -Parent $MyInvocation.MyCommand.Path
+$profile = "default"
+$telegramMode = "inherit"
+$workspace = ""
+$remoteControl = $false
+$printOnly = $false
+$promptParts = @()
+$parsedArgs = @($args)
+
+if ($parsedArgs.Count -gt 0) {
+  switch ($parsedArgs[0]) {
+    "telegram-status" {
+      $commandArgs = @()
+      if ($parsedArgs.Count -gt 1) {
+        $commandArgs = @($parsedArgs[1..($parsedArgs.Count - 1)])
+      }
+      & powershell -ExecutionPolicy Bypass -File (Join-Path $runtimeRoot "telegram-status.ps1") @commandArgs
+      exit $LASTEXITCODE
+    }
+    "telegram-doctor" {
+      $commandArgs = @()
+      if ($parsedArgs.Count -gt 1) {
+        $commandArgs = @($parsedArgs[1..($parsedArgs.Count - 1)])
+      }
+      & powershell -ExecutionPolicy Bypass -File (Join-Path $runtimeRoot "telegram-doctor.ps1") @commandArgs
+      exit $LASTEXITCODE
+    }
+    "doctor" {
+      $commandArgs = @()
+      if ($parsedArgs.Count -gt 1) {
+        $commandArgs = @($parsedArgs[1..($parsedArgs.Count - 1)])
+      }
+      & powershell -ExecutionPolicy Bypass -File (Join-Path $runtimeRoot "telegram-doctor.ps1") @commandArgs
+      exit $LASTEXITCODE
+    }
+    "telegram-plugin" {
+      $telegramMode = "plugin"
+      if ($parsedArgs.Count -gt 1) {
+        $parsedArgs = @($parsedArgs[1..($parsedArgs.Count - 1)])
+      } else {
+        $parsedArgs = @()
+      }
+    }
+  }
+}
+
+for ($i = 0; $i -lt $parsedArgs.Count; $i++) {
+  $arg = $parsedArgs[$i]
+  switch ($arg) {
+    "--profile" {
+      $i++
+      if ($i -ge $parsedArgs.Count) { throw "--profile requires a value" }
+      $profile = $parsedArgs[$i]
+      continue
+    }
+    "--telegram" {
+      $i++
+      if ($i -ge $parsedArgs.Count) { throw "--telegram requires a value" }
+      $telegramMode = $parsedArgs[$i]
+      continue
+    }
+    "--workspace" {
+      $i++
+      if ($i -ge $parsedArgs.Count) { throw "--workspace requires a value" }
+      $workspace = $parsedArgs[$i]
+      continue
+    }
+    "--remote-control" {
+      $remoteControl = $true
+      continue
+    }
+    "--print-only" {
+      $printOnly = $true
+      continue
+    }
+    default {
+      $promptParts += $arg
+    }
+  }
+}
+
+$invokeArgs = @(
+  "-ExecutionPolicy", "Bypass",
+  "-File", (Join-Path $runtimeRoot "start-codex-agent.ps1"),
+  "-Agent", $profile,
+  "-TelegramMode", $telegramMode
+)
+
+if ($workspace) {
+  $invokeArgs += "-Workspace"
+  $invokeArgs += $workspace
+}
+
+if ($remoteControl) {
+  $invokeArgs += "-RemoteControl"
+}
+
+if ($printOnly) {
+  $invokeArgs += "-PrintOnly"
+}
+
+if ($promptParts.Count -gt 0) {
+  $invokeArgs += "-Prompt"
+  $invokeArgs += ($promptParts -join " ")
+}
+
+& powershell @invokeArgs
+exit $LASTEXITCODE

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@blunking/codexlink",
+  "version": "0.1.0",
+  "description": "BLUN CLI launcher with Telegram channel support for one visible session.",
+  "license": "MIT",
+  "private": false,
+  "bin": {
+    "blun-codex": "./bin/blun-codex.js",
+    "codexlink": "./bin/blun-codex.js"
+  },
+  "files": [
+    "bin/",
+    "profiles/",
+    "telegram-plugin/",
+    "README.md",
+    "LICENSE",
+    "blun-codex.cmd",
+    "blun-codex.ps1",
+    "start-codex-agent.ps1",
+    "start-codex.cmd",
+    "telegram-status.ps1",
+    "telegram-doctor.ps1"
+  ],
+  "keywords": [
+    "blun",
+    "codexlink",
+    "telegram",
+    "runtime",
+    "cli"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}

package/profiles/default.json

@@ -0,0 +1,20 @@
+{
+  "agent_name": "default",
+  "display_name": "CodexLink",
+  "lane": "general",
+  "workspace": "",
+  "model": "",
+  "reasoning_effort": "xhigh",
+  "sandbox": "danger-full-access",
+  "approval_policy": "never",
+  "personality": "friendly",
+  "mnemo": {
+    "inherit": true,
+    "notes": "Public default profile. Uses the host-default Mnemo binding unless a custom profile is selected."
+  },
+  "telegram": {
+    "enabled": false,
+    "state_dir": "",
+    "allowed_chat_id": ""
+  }
+}