@poridhi/pukucode 0.1.1

package/LICENSE

@@ -0,0 +1,29 @@
+NOTICE
+
+This repository contains code derived from Anthropic's Claude Code CLI.
+
+The original Claude Code source is proprietary software:
+  Copyright (c) Anthropic PBC. All rights reserved.
+  Subject to Anthropic's Commercial Terms of Service.
+
+Modifications and additions by OpenClaude contributors are offered under
+the MIT License where legally permissible:
+
+  MIT License
+  Copyright (c) 2026 OpenClaude contributors (modifications only)
+
+  Permission is hereby granted, free of charge, to any person obtaining
+  a copy of the modifications made by OpenClaude contributors, to deal
+  in those modifications without restriction, including without limitation
+  the rights to use, copy, modify, merge, publish, distribute, sublicense,
+  and/or sell copies, subject to the following conditions:
+
+  The above copyright notice and this permission notice shall be included
+  in all copies or substantial portions of the modifications.
+
+  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND.
+
+The underlying derived code remains subject to Anthropic's copyright.
+This project does not have Anthropic's authorization to distribute
+their proprietary source. Users and contributors should evaluate their
+own legal position.

package/README.md

@@ -0,0 +1,122 @@
+# Puku CLI
+
+Puku CLI (`pukucode`) is an AI coding assistant powered by Poridhi Agentic Workflow. It provides a terminal-first coding agent experience backed by the Puku Worker infrastructure and MiniMax models.
+
+## Features
+
+- Google OAuth authentication via Puku Worker
+- MiniMax M2.5 model via Puku Worker infrastructure
+- Terminal-first coding workflow: prompts, tools, agents, slash commands, streaming output
+- Bash, file read/write/edit, grep, glob, agents, tasks, MCP, and web tools
+- Session caching — login once, stay authenticated for 7 days
+
+---
+
+## Quick Start
+
+### Install
+
+```bash
+npm install -g @poridhi/pukucode
+```
+
+### Configure
+
+Create a `.env` file or export these variables:
+
+```bash
+export PUKU_AUTH=true
+export PUKU_WORKER_URL=https://api.puku.sh
+export ANTHROPIC_MODEL=MiniMax-M2.5
+export APP_NAME=pukucode
+export APP_CLI_NAME=Puku CLI
+```
+
+### Start
+
+```bash
+pukucode
+```
+
+On first run, a browser window will open for Google login. After authenticating, the session is cached at `~/.config/pukucode/session.json` and reused on subsequent runs.
+
+---
+
+## How It Works
+
+```
+pukucode CLI
+    │  Google session token (Bearer)
+    ▼
+api.puku.sh/v1/messages  →  validates session  →  MiniMax API
+```
+
+- Authentication is handled via Google OAuth through Puku Worker
+- The MiniMax API key never leaves the server — only your Google session token is used on the client
+- Sessions expire after 7 days, after which the browser login flow triggers again automatically
+
+---
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `PUKU_AUTH` | Yes | Set to `true` to enable Google OAuth mode |
+| `PUKU_WORKER_URL` | Yes | Puku Worker base URL (e.g. `https://api.puku.sh`) |
+| `ANTHROPIC_MODEL` | Yes | Model to use (e.g. `MiniMax-M2.5`) |
+| `APP_NAME` | No | App name (default: `pukucode`) |
+| `APP_CLI_NAME` | No | CLI display name (default: `Puku CLI`) |
+| `APP_TAGLINE` | No | Startup screen tagline |
+| `SHOW_LOGO` | No | Set to `false` to hide ASCII logo |
+
+---
+
+## Session Management
+
+Sessions are stored locally at:
+```
+~/.config/pukucode/session.json
+```
+
+To log out and re-authenticate:
+```bash
+rm ~/.config/pukucode/session.json
+pukucode
+```
+
+---
+
+## Source Build
+
+```bash
+git clone <repo>
+cd openclaude
+bun install
+bun run build
+node dist/cli.mjs
+```
+
+For development with live env:
+```bash
+set -a && source .env.local && set +a && bun run dev
+```
+
+---
+
+## Security
+
+- Google session tokens are stored locally with `0600` permissions
+- MiniMax API keys are never exposed to the client
+- All API calls go through Puku Worker which validates your session on every request
+
+---
+
+## Disclaimer
+
+Puku CLI is built on top of an open-source CLI codebase and is powered by Poridhi Agentic Workflow. It is not affiliated with Anthropic.
+
+---
+
+## License
+
+MIT

package/bin/import-specifier.mjs

@@ -0,0 +1,7 @@
+import { join } from 'path'
+import { pathToFileURL } from 'url'
+
+export function getDistImportSpecifier(baseDir) {
+  const distPath = join(baseDir, '..', 'dist', 'cli.mjs')
+  return pathToFileURL(distPath).href
+}

package/bin/import-specifier.test.mjs

@@ -0,0 +1,13 @@
+import assert from 'node:assert/strict'
+import test from 'node:test'
+
+import { getDistImportSpecifier } from './import-specifier.mjs'
+
+test('builds a file URL import specifier for dist/cli.mjs', () => {
+  const specifier = getDistImportSpecifier('C:\\repo\\bin')
+
+  assert.equal(
+    specifier,
+    'file:///C:/repo/dist/cli.mjs',
+  )
+})

package/bin/openclaude

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+
+/**
+ * OpenClaude — Claude Code with any LLM
+ *
+ * If dist/cli.mjs exists (built), run that.
+ * Otherwise, tell the user to build first or use `bun run dev`.
+ */
+
+import { existsSync } from 'fs'
+import { join, dirname } from 'path'
+import { fileURLToPath, pathToFileURL } from 'url'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const distPath = join(__dirname, '..', 'dist', 'cli.mjs')
+
+if (existsSync(distPath)) {
+  await import(pathToFileURL(distPath).href)
+} else {
+  console.error(`
+  openclaude: dist/cli.mjs not found.
+
+  Build first:
+    bun run build
+
+  Or run directly with Bun:
+    bun run dev
+
+  See README.md for setup instructions.
+`)
+  process.exit(1)
+}