@renxqoo/renx-code 0.0.3 → 0.0.5

package/README.md

@@ -1,146 +1,97 @@
-# Renx Code
+# OpenTUI Agent CLI (React + Bun)
 
-[![npm version](https://img.shields.io/npm/v/@renxqoo/renx-code.svg)](https://www.npmjs.com/package/@renxqoo/renx-code)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Bun Version](https://img.shields.io/badge/Bun-%3E%3D1.1.0-black.svg)](https://bun.sh/)
-[![TypeScript](https://img.shields.io/badge/TypeScript-5.9-blue.svg)](https://www.typescriptlang.org/)
-[![React](https://img.shields.io/badge/React-19.2-blue.svg)](https://react.dev/)
-[![OpenTUI](https://img.shields.io/badge/OpenTUI-0.1.84-green.svg)](https://github.com/opentui/opentui)
-
-Enterprise-grade AI coding assistant CLI tool with interactive terminal UI, built with React and OpenTUI.
-
-## ✨ Features
-
-- **Interactive Terminal UI**: Beautiful, responsive terminal interface built with React and OpenTUI
-- **AI-Powered Assistance**: Intelligent code suggestions and completions
-- **Slash Commands**: Built-in commands for common operations (`/help`, `/clear`, `/exit`, `/models`, `/files`)
-- **Keyboard Shortcuts**: Efficient navigation and control
-- **Configurable**: Extensive configuration options via environment variables and config files
-- **Cross-Platform**: Works on Windows, macOS, and Linux
-- **TypeScript**: Full type safety and excellent developer experience
-- **Real-time Updates**: Live terminal updates with smooth animations
-- **Theme Support**: Customizable UI themes and markdown rendering
-
-## 🚀 Quick Start
-
-### Installation
+Initialized from the latest OpenTUI React template:
 
 ```bash
-# Run directly with Bun
-bunx @renxqoo/renx-code
+bun create tui --template react opentui-agent-cli
+```
 
-# Or install globally with Bun
-bun install -g @renxqoo/renx-code
+Current package versions:
 
-# npm install is not supported for running this CLI because OpenTUI currently depends on Bun runtime APIs.
-```
+- `@opentui/core`: `0.1.84`
+- `@opentui/react`: `0.1.84`
+- `react`: `19.2.4`
 
-### Basic Usage
+## Run
 
 ```bash
-# Start the interactive CLI
-renx
-
-# Or run directly with bunx
-bunx @renxqoo/renx-code
+bun dev
 ```
 
-## 📦 Installation
-
-### Prerequisites
-
-- Bun 1.1.0 or higher
-
-### Global Installation
+Optional hot reload (less stable for interactive TUI signal handling):
 
 ```bash
-bun install -g @renxqoo/renx-code
+bun run dev:watch
 ```
 
-### Local Installation
+## What is implemented
 
-```bash
-# Create a new project
-mkdir my-project && cd my-project
-npm init -y
+- Agent-style CLI chat layout (header, conversation panel, prompt input)
+- Built-in commands: `/help`, `/clear`, `/exit`
+- Keyboard shortcuts: `Esc` (stop current response when thinking, otherwise clear input), `Ctrl+L` (clear conversation)
+- Simulated async agent reply flow
 
-# Install @renxqoo/renx-code
-npm install @renxqoo/renx-code
+## Main file
 
-# Add to package.json scripts
-{
-  "scripts": {
-    "agent": "renx"
-  }
-}
-```
+- `src/index.tsx`
 
-## 🎯 Usage
+## Configuration
 
-### Interactive Mode
+OpenTUI Agent CLI uses the shared Renx config system.
 
-```bash
-renx
-```
+Effective precedence is:
 
-This launches the interactive terminal UI where you can:
-- Type natural language queries
-- Use slash commands (`/help`, `/clear`, `/exit`)
-- Navigate with keyboard shortcuts
-- View real-time AI responses
+1. Existing process environment variables plus values loaded from `.env` / `.env.development`
+2. Project config: `<workspace>/.renx/config.json`
+3. Global config: `RENX_HOME/config.json`
+4. Built-in defaults
 
-### Keyboard Shortcuts
+Directory-related state is managed from a single root:
 
-| Shortcut | Action |
-|----------|--------|
-| `Esc` | Stop current response or clear input |
-| `Ctrl+L` | Clear conversation |
-| `Ctrl+C` | Exit application |
-| `↑/↓` | Navigate command history |
-| `Tab` | Auto-complete commands |
-| `Enter` | Submit input |
+- `RENX_HOME` defaults to `~/.renx`
+- `RENX_HOME/config.json` for global config
+- `RENX_HOME/logs/` for log files
+- `RENX_HOME/storage/` for file-history storage
+- `RENX_HOME/task/` for task data
+- `RENX_HOME/data.db` for the shared SQLite database
 
-### Slash Commands
+## Supported Environment Variables
 
-| Command | Description |
-|---------|-------------|
-| `/help` | Show available commands and shortcuts |
-| `/clear` | Clear the conversation history |
-| `/exit` | Exit the application |
-| `/models` | List available AI models |
-| `/files` | Show file browser |
-| `/config` | Show current configuration |
-| `/status` | Show system status |
+Application/runtime variables:
 
-## ⚙️ Configuration
+- `RENX_HOME`: overrides the user-level Renx home directory
+- `AGENT_MODEL`: default model id
+- `AGENT_MAX_STEPS`: max steps per run
+- `AGENT_MAX_RETRY_COUNT`: agent retry count
+- `AGENT_TOOL_CONFIRMATION_MODE`: `manual`, `auto-approve`, or `auto-deny`
+- `AGENT_CONVERSATION_ID`: fixed conversation id for the CLI runtime
+- `AGENT_SESSION_ID`: fallback session id when `AGENT_CONVERSATION_ID` is unset
 
-### Environment Variables
+Logging variables:
 
-Configure the agent using environment variables:
-
-```bash
-# Set the AI model
-export AGENT_MODEL="gpt-4"
+- `AGENT_LOG_LEVEL`: `TRACE`, `DEBUG`, `INFO`, `WARN`, `ERROR`, or `FATAL`
+- `AGENT_LOG_FORMAT`: `pretty` or `json`
+- `AGENT_LOG_CONSOLE`: enable/disable console logging
+- `AGENT_LOG_FILE_ENABLED`: enable/disable file logging
 
-# Set maximum steps per run
-export AGENT_MAX_STEPS=1000
+File history variables:
 
-# Set confirmation mode
-export AGENT_TOOL_CONFIRMATION_MODE="manual"
+- `AGENT_FILE_HISTORY_ENABLED`
+- `AGENT_FILE_HISTORY_MAX_PER_FILE`
+- `AGENT_FILE_HISTORY_MAX_AGE_DAYS`
+- `AGENT_FILE_HISTORY_MAX_TOTAL_MB`
 
-# Set logging level
-export AGENT_LOG_LEVEL="INFO"
-```
+Model provider API keys are still provided through their own env vars such as `GLM_API_KEY`.
 
-### Configuration Files
+## Config File Shape
 
-Create a configuration file at `~/.renx/config.json`:
+Global and project config files use the same JSON structure:
 
 ```json
 {
   "agent": {
-    "defaultModel": "gpt-4",
-    "maxSteps": 1000,
+    "defaultModel": "qwen3.5-plus",
+    "maxSteps": 10000,
     "confirmationMode": "manual"
   },
   "log": {
@@ -160,120 +111,4 @@ Create a configuration file at `~/.renx/config.json`:
 }
 ```
 
-### Project Configuration
-
-Create a project-specific config at `.renx/config.json` in your project root.
-
-## 🔧 Development
-
-### Setup
-
-```bash
-# Clone the repository
-git clone https://github.com/renxqoo/renx-code.git
-cd renx-code
-
-# Install dependencies
-npm install
-
-# Start development server
-npm run dev
-```
-
-### Build
-
-```bash
-# Build for production
-npm run build
-
-# Build CLI executable
-npm run build:cli
-```
-
-### Testing
-
-```bash
-# Run tests
-npm test
-
-# Run tests with coverage
-npm run test:coverage
-```
-
-### Linting and Formatting
-
-```bash
-# Fix linting issues
-npm run lint:fix
-
-# Format code
-npm run format
-```
-
-## 📁 Project Structure
-
-```
-@renxqoo/renx-code/
-├── src/
-│   ├── agent/          # AI agent logic
-│   ├── commands/       # Slash commands
-│   ├── components/     # React components
-│   ├── runtime/        # Runtime utilities
-│   ├── ui/             # UI themes and styling
-│   ├── utils/          # Utility functions
-│   ├── App.tsx         # Main application component
-│   ├── cli.tsx         # CLI entry point
-│   └── index.tsx       # Library entry point
-├── dist/               # Compiled output
-├── package.json        # Package configuration
-├── tsconfig.json       # TypeScript configuration
-├── tsconfig.build.json # Build TypeScript configuration
-└── README.md           # This file
-```
-
-## 🤝 Contributing
-
-1. Fork the repository
-2. Create your feature branch (`git checkout -b feature/amazing-feature`)
-3. Commit your changes (`git commit -m 'Add some amazing feature'`)
-4. Push to the branch (`git push origin feature/amazing-feature`)
-5. Open a Pull Request
-
-### Development Guidelines
-
-- Follow TypeScript best practices
-- Write tests for new features
-- Update documentation as needed
-- Follow the existing code style
-
-## 📄 License
-
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
-
-## 🙏 Acknowledgments
-
-- [OpenTUI](https://github.com/opentui/opentui) - Terminal UI framework
-- [React](https://react.dev/) - UI library
-- [TypeScript](https://www.typescriptlang.org/) - Type safety
-- [Vitest](https://vitest.dev/) - Testing framework
-
-## 📞 Support
-
-- **Issues**: [GitHub Issues](https://github.com/renxqoo/renx-code/issues)
-- **Discussions**: [GitHub Discussions](https://github.com/renxqoo/renx-code/discussions)
-- **Documentation**: [Wiki](https://github.com/renxqoo/renx-code/wiki)
-
-## 🚀 Roadmap
-
-- [ ] Plugin system for custom commands
-- [ ] Multi-model support
-- [ ] Codebase analysis features
-- [ ] Integration with popular IDEs
-- [ ] Cloud sync for configurations
-- [ ] Team collaboration features
-- [ ] Performance optimizations
-- [ ] Enhanced error handling and recovery
-
----
-
-**Note**: This is an enterprise-grade tool designed for professional developers. Please ensure you have appropriate API keys and permissions for the AI models you intend to use.
+There are no per-directory config fields anymore. All user-level paths are derived from `RENX_HOME`.

package/bin/renx.cjs

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+
+const childProcess = require("node:child_process");
+const fs = require("node:fs");
+const path = require("node:path");
+
+const packageRoot = path.resolve(__dirname, "..");
+const entryPath = path.join(packageRoot, "src", "index.tsx");
+const packagedRepoRoot = path.join(packageRoot, "vendor", "agent-root");
+const localRepoRoot = path.resolve(packageRoot, "..");
+const bunExecutable = process.env.RENX_BUN_PATH || "bun";
+
+const hasAgentSourceRoot = root =>
+  fs.existsSync(path.join(root, "src", "providers", "index.ts")) &&
+  fs.existsSync(path.join(root, "src", "config", "index.ts")) &&
+  fs.existsSync(path.join(root, "src", "agent", "app", "index.ts"));
+
+const resolvedRepoRoot =
+  process.env.AGENT_REPO_ROOT ||
+  (hasAgentSourceRoot(packagedRepoRoot)
+    ? packagedRepoRoot
+    : hasAgentSourceRoot(localRepoRoot)
+      ? localRepoRoot
+      : undefined);
+
+if (!fs.existsSync(entryPath)) {
+  console.error(`Could not find CLI entrypoint: ${entryPath}`);
+  process.exit(1);
+}
+
+const result = childProcess.spawnSync(bunExecutable, [entryPath, ...process.argv.slice(2)], {
+  cwd: process.cwd(),
+  stdio: "inherit",
+  env: {
+    ...process.env,
+    AGENT_WORKDIR: process.env.AGENT_WORKDIR || process.cwd(),
+    ...(resolvedRepoRoot ? { AGENT_REPO_ROOT: resolvedRepoRoot } : {}),
+  },
+});
+
+if (result.error) {
+  if (result.error.code === "ENOENT") {
+    console.error("Bun is required to run renx. Install Bun first: https://bun.sh");
+  } else {
+    console.error(result.error.message);
+  }
+  process.exit(1);
+}
+
+process.exit(typeof result.status === "number" ? result.status : 0);

package/package.json

@@ -1,93 +1,22 @@
 {
   "name": "@renxqoo/renx-code",
-  "version": "0.0.3",
-  "description": "Enterprise-grade AI coding assistant CLI tool with interactive terminal UI",
+  "version": "0.0.5",
+  "module": "src/index.tsx",
   "type": "module",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
+  "private": false,
   "bin": {
-    "renx": "./dist/cli.js"
-  },
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
-    },
-    "./cli": {
-      "import": "./dist/cli.js"
-    }
+    "renx": "./bin/renx.cjs"
   },
   "files": [
-    "dist",
+    "bin",
+    "src",
+    "vendor",
     "README.md",
-    "LICENSE"
-  ],
-  "scripts": {
-    "dev": "bun run src/index.tsx",
-    "dev:watch": "bun run --watch src/index.tsx",
-    "build": "tsc -p tsconfig.build.json && node ./scripts/fix-esm-imports.mjs",
-    "build:cli": "npm run build && node -e \"require('fs').chmodSync('dist/cli.js', 0o755)\"",
-    "start": "node dist/index.js",
-    "test": "vitest",
-    "test:coverage": "vitest run --coverage",
-    "lint": "eslint . --ext .ts,.tsx",
-    "lint:fix": "eslint . --ext .ts,.tsx --fix",
-    "format": "prettier --write .",
-    "format:check": "prettier --check .",
-    "type-check": "tsc --noEmit",
-    "check": "bun run type-check && bun run lint && bun run format:check",
-    "prepare": "echo 'Skipping husky install'",
-    "prepublishOnly": "npm run build:cli",
-    "prepack": "npm run build:cli",
-    "publish:patch": "npm version patch && npm run build:cli && npm publish",
-    "publish:minor": "npm version minor && npm run build:cli && npm publish",
-    "publish:major": "npm version major && npm run build:cli && npm publish"
-  },
-  "keywords": [
-    "ai",
-    "coding",
-    "agent",
-    "cli",
-    "terminal",
-    "tui",
-    "react",
-    "assistant",
-    "developer-tools",
-    "productivity",
-    "opentui"
+    "tsconfig.json"
   ],
-  "author": "",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/renxqoo/renx-code.git"
-  },
-  "bugs": {
-    "url": "https://github.com/renxqoo/renx-code/issues"
-  },
-  "homepage": "https://github.com/renxqoo/renx-code#readme",
-  "devDependencies": {
-    "@eslint/js": "^10.0.1",
-    "@testing-library/react": "^16.3.2",
-    "@testing-library/react-hooks": "^8.0.1",
-    "@testing-library/user-event": "^14.6.1",
-    "@types/bun": "latest",
-    "@types/react": "^19.2.14",
-    "@types/react-dom": "^19.2.3",
-    "@typescript-eslint/eslint-plugin": "^8.57.0",
-    "@typescript-eslint/parser": "^8.57.0",
-    "eslint": "^10.0.3",
-    "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-prettier": "^5.5.5",
-    "eslint-plugin-react": "^7.37.5",
-    "eslint-plugin-react-hooks": "^7.0.1",
-    "globals": "^17.4.0",
-    "prettier": "^3.8.1",
-    "whistle": "^2.10.1",
-    "husky": "^8.0.3",
-    "lint-staged": "^16.3.2",
-    "typescript": "^5.9.3",
-    "vitest": "^1.1.0"
+  "engines": {
+    "node": ">=20.0.0",
+    "bun": ">=1.1.0"
   },
   "peerDependencies": {
     "typescript": "^5.9.3"
@@ -95,34 +24,6 @@
   "dependencies": {
     "@opentui/core": "^0.1.84",
     "@opentui/react": "^0.1.84",
-    "react": "^19.2.4",
-    "@vscode/ripgrep": "^1.17.0",
-    "diff": "^8.0.3",
-    "dotenv": "^17.3.1",
-    "js-tiktoken": "^1.0.21",
-    "log-update": "^6.1.0",
-    "marked": "^15.0.12",
-    "marked-terminal": "^7.3.0",
-    "minimatch": "^10.2.4",
-    "shell-quote": "^1.8.3",
-    "strip-ansi": "^7.2.0",
-    "uuid": "^13.0.0",
-    "zod": "^4.3.6"
-  },
-  "engines": {
-    "bun": ">=1.1.0"
-  },
-  "lint-staged": {
-    "*.ts": [
-      "prettier --write",
-      "eslint --fix"
-    ],
-    "*.tsx": [
-      "prettier --write",
-      "eslint --fix"
-    ],
-    "*.{json,md}": [
-      "prettier --write"
-    ]
+    "react": "^19.2.4"
   }
 }