pico-ai 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Umesh
+
+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,99 @@
+# Pico
+
+A fast and tiny AI coding agent.
+
+## Install
+
+### npm (global)
+
+```bash
+npm install -g pico-agent
+```
+
+### curl (macOS/Linux)
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/imumesh18/pico/main/scripts/install.sh | sh
+```
+
+Install a specific release tag:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/imumesh18/pico/main/scripts/install.sh | sh -s -- -v v0.0.1
+```
+
+### direct binary download
+
+Download from [GitHub Releases](https://github.com/imumesh18/pico/releases):
+
+- `pico-darwin-arm64`
+- `pico-darwin-x64`
+- `pico-linux-arm64`
+- `pico-linux-x64`
+- `pico-windows-x64.exe`
+
+Verify with the matching `.sha256` file, then:
+
+```bash
+chmod +x ./pico-linux-x64
+./pico-linux-x64 --help
+```
+
+## Development
+
+```bash
+bun run setup
+```
+
+Run in watch mode:
+
+```bash
+bun run dev
+```
+
+Quality and build:
+
+```bash
+bun run ci
+```
+
+## Publishing
+
+The package name stays `pico` in this repo, but publishes to npm as `pico-agent` to avoid conflicts.
+
+```bash
+bun run publish:npm
+```
+
+One-command publish (runs full CI first):
+
+```bash
+bun run ship
+```
+
+Override the publish name if needed:
+
+```bash
+PICO_PUBLISH_NAME=your-name bun run publish:npm
+```
+
+## Release flow
+
+Best flow (manual-only via GitHub Actions):
+
+1. Merge changes to `main` using conventional commits.
+2. Trigger the Release workflow manually from GitHub Actions. It computes the next version, updates `package.json` and `CHANGELOG.md`, tags the release, builds binaries, publishes the GitHub release, and publishes to npm.
+
+Local dry-run (optional):
+
+```bash
+bun run release
+```
+
+Required GitHub repository secret:
+
+- `NPM_TOKEN` (npm publish token)
+
+## License
+
+MIT

package/bin/pico.js

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const here = dirname(fileURLToPath(import.meta.url));
+const root = dirname(here);
+const platform = `${process.platform}-${process.arch}`;
+const binaryName = process.platform === "win32" ? "pico.exe" : "pico";
+const binaryPath = join(root, "vendor", platform, binaryName);
+
+if (!existsSync(binaryPath)) {
+  console.error(`[pico] No prebuilt binary found for ${platform}.`);
+  console.error(
+    "[pico] Reinstall with network access or use the curl installer: https://github.com/imumesh18/pico#install",
+  );
+  process.exit(1);
+}
+
+const child = spawn(binaryPath, process.argv.slice(2), {
+  stdio: "inherit",
+});
+
+child.on("error", (error) => {
+  console.error(`[pico] Failed to start binary: ${String(error)}`);
+  process.exit(1);
+});
+
+child.on("exit", (code) => {
+  process.exit(code ?? 1);
+});

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "pico-ai",
+  "version": "0.0.1",
+  "description": "Pico: A fast and tiny AI coding agent.",
+  "keywords": [
+    "agent",
+    "ai",
+    "bun",
+    "cli",
+    "opentui"
+  ],
+  "homepage": "https://github.com/imumesh18/pico#readme",
+  "bugs": {
+    "url": "https://github.com/imumesh18/pico/issues"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/imumesh18/pico.git"
+  },
+  "bin": {
+    "pico": "./bin/pico.js"
+  },
+  "files": [
+    "bin/pico.js",
+    "scripts/npm-postinstall.mjs",
+    "README.md",
+    "LICENSE"
+  ],
+  "type": "module",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "scripts": {
+    "setup": "bun install",
+    "dev": "bun --watch src/cli.ts",
+    "build": "rm -rf dist && bun build ./src/cli.ts --target bun --format esm --outdir ./dist --packages external --sourcemap && chmod +x ./dist/cli.js",
+    "typecheck": "bunx tsc --noEmit",
+    "lint": "bunx oxlint --deny-warnings --import-plugin src",
+    "lint:fix": "bunx oxlint --import-plugin --fix src",
+    "format": "bunx oxfmt --write .",
+    "format:check": "bunx oxfmt --check .",
+    "quality": "bun run format:check && bun run lint",
+    "quality:fix": "bun run format && bun run lint:fix",
+    "test": "bun test --pass-with-no-tests",
+    "check": "bun run quality && bun run typecheck && bun run test",
+    "ci": "bun run check && bun run build",
+    "release": "node ./scripts/prepare-release.mjs",
+    "ship": "bun run ci && bun run publish:npm",
+    "changelog": "bunx git-cliff --config cliff.toml --unreleased",
+    "postinstall": "node ./scripts/npm-postinstall.mjs || bun ./scripts/npm-postinstall.mjs",
+    "prepublishOnly": "bun run ci",
+    "publish:npm": "node ./scripts/npm-publish.mjs"
+  },
+  "dependencies": {
+    "@opentui/core": "^0.1.77",
+    "effect": "^3.19.16"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.3.8",
+    "git-cliff": "^2.12.0",
+    "oxfmt": "^0.28.0",
+    "oxlint": "^1.43.0",
+    "typescript": "^5.9.3"
+  },
+  "engines": {
+    "bun": ">=1.3.8",
+    "node": ">=18"
+  },
+  "packageManager": "bun@1.3.8"
+}

package/scripts/npm-postinstall.mjs

@@ -0,0 +1,122 @@
+import { chmodSync, createWriteStream, existsSync, mkdirSync, renameSync, rmSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { get } from "node:https";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const platformMap = {
+  "darwin-arm64": "pico-darwin-arm64",
+  "darwin-x64": "pico-darwin-x64",
+  "linux-arm64": "pico-linux-arm64",
+  "linux-x64": "pico-linux-x64",
+  "win32-x64": "pico-windows-x64.exe",
+};
+
+const log = (message) => {
+  process.stdout.write(`[pico] ${message}\n`);
+};
+
+const warn = (message) => {
+  process.stderr.write(`[pico] ${message}\n`);
+};
+
+const download = (url, destination) =>
+  new Promise((resolve, reject) => {
+    const file = createWriteStream(destination);
+    const request = get(
+      url,
+      {
+        headers: {
+          "user-agent": "pico-npm-installer",
+        },
+      },
+      (response) => {
+        if (
+          response.statusCode &&
+          response.statusCode >= 300 &&
+          response.statusCode < 400 &&
+          response.headers.location
+        ) {
+          file.close();
+          rmSync(destination, { force: true });
+          resolve(download(response.headers.location, destination));
+          return;
+        }
+
+        if (response.statusCode !== 200) {
+          reject(new Error(`Download failed with status ${response.statusCode ?? "unknown"}`));
+          return;
+        }
+
+        response.pipe(file);
+        file.on("finish", () => {
+          file.close();
+          resolve(undefined);
+        });
+      },
+    );
+
+    request.on("error", (error) => {
+      file.close();
+      rmSync(destination, { force: true });
+      reject(error);
+    });
+  });
+
+const run = async () => {
+  if (process.env.PICO_SKIP_BINARY_DOWNLOAD === "1") {
+    log("Skipping binary download because PICO_SKIP_BINARY_DOWNLOAD=1.");
+    return;
+  }
+
+  const key = `${process.platform}-${process.arch}`;
+  const assetName = platformMap[key];
+
+  if (!assetName) {
+    warn(`No prebuilt binary is published for ${key}.`);
+    return;
+  }
+
+  const scriptsDir = dirname(fileURLToPath(import.meta.url));
+  const root = dirname(scriptsDir);
+
+  if (existsSync(join(root, ".git"))) {
+    log("Skipping binary download in a git checkout.");
+    return;
+  }
+
+  const packageJsonPath = join(root, "package.json");
+  const packageJson = JSON.parse(await readFile(packageJsonPath, "utf8"));
+  const version = packageJson.version;
+  const tag = `v${version}`;
+  const platformDir = join(root, "vendor", key);
+  const binaryName = process.platform === "win32" ? "pico.exe" : "pico";
+  const binaryPath = join(platformDir, binaryName);
+
+  if (existsSync(binaryPath)) {
+    log(`Binary already present at ${binaryPath}.`);
+    return;
+  }
+
+  mkdirSync(platformDir, { recursive: true });
+  const tempPath = `${binaryPath}.tmp`;
+  const url = `https://github.com/imumesh18/pico/releases/download/${tag}/${assetName}`;
+
+  try {
+    log(`Downloading ${assetName} for ${key}...`);
+    await download(url, tempPath);
+    renameSync(tempPath, binaryPath);
+    if (process.platform !== "win32") {
+      chmodSync(binaryPath, 0o755);
+    }
+    log(`Installed binary at ${binaryPath}.`);
+  } catch (error) {
+    rmSync(tempPath, { force: true });
+    warn(
+      `Could not download ${assetName} from ${url}. Install from source with Bun, or use the curl installer from https://github.com/imumesh18/pico#install.`,
+    );
+    warn(String(error));
+  }
+};
+
+await run();