ops-toolkit 1.1.0

package/.vscode/extensions.json

@@ -0,0 +1,14 @@
+{
+  "recommendations": [
+    "oven.bun-vscode",
+    "ms-vscode.vscode-typescript-next",
+    "ms-vscode.vscode-eslint",
+    "esbenp.prettier-vscode",
+    "streetsidesoftware.code-spell-checker",
+    "eamodio.gitlens",
+    "christian-kohler.path-intellisense",
+    "usernamehw.errorlens",
+    "wayou.vscode-todo-highlight",
+    "gruntfuggly.todo-tree"
+  ]
+}

package/.vscode/launch.json

@@ -0,0 +1,33 @@
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "name": "调试 CLI (tsx)",
+      "type": "node",
+      "request": "launch",
+      "program": "${workspaceFolder}/node_modules/.bin/tsx",
+      "args": ["${workspaceFolder}/src/index.ts"],
+      "console": "integratedTerminal",
+      "internalConsoleOptions": "neverOpen",
+      "skipFiles": ["<node_internals>/**"]
+    },
+    {
+      "name": "调试指定命令 (tsx)",
+      "type": "node",
+      "request": "launch",
+      "program": "${workspaceFolder}/node_modules/.bin/tsx",
+      "args": ["${workspaceFolder}/src/index.ts", "${input:command}"],
+      "console": "integratedTerminal",
+      "internalConsoleOptions": "neverOpen",
+      "skipFiles": ["<node_internals>/**"]
+    }
+  ],
+  "inputs": [
+    {
+      "id": "command",
+      "type": "promptString",
+      "description": "输入 CLI 命令 (如 monitor, logs, deploy, system)",
+      "default": "ui"
+    }
+  ]
+}

package/.vscode/typescript.code-snippets

@@ -0,0 +1,61 @@
+{
+  "TypeScript CLI Command": {
+    "prefix": "cli-cmd",
+    "body": [
+      "program",
+      "  .command('${1:commandName}')",
+      "  .description('${2:Description}')",
+      "  .action(async (${3:options}) => {",
+      "    $0",
+      "  });"
+    ],
+    "description": "Create a new CLI command"
+  },
+  "TypeScript Async Function": {
+    "prefix": "async-fn",
+    "body": [
+      "async function ${1:functionName}(${2:args}): Promise<${3:returnType}> {",
+      "  $0",
+      "}"
+    ],
+    "description": "Create an async function"
+  },
+  "Try-Catch Error Handler": {
+    "prefix": "try-catch",
+    "body": [
+      "try {",
+      "  $0",
+      "} catch (error) {",
+      "  console.error(chalk.red('❌ Error:'), error);",
+      "  process.exit(1);",
+      "}"
+    ],
+    "description": "Try-catch with error handling"
+  },
+  "Chalk Colored Log": {
+    "prefix": "log",
+    "body": ["console.log(chalk.${1|red,green,yellow,blue,magenta,cyan,gray,white}('$2'));"],
+    "description": "Colored console log with chalk"
+  },
+  "Commander Option": {
+    "prefix": "cmd-opt",
+    "body": ["program.option('${1:-f, --flag}', '${2:description}', ${3|true,false|});"],
+    "description": "Add a Commander CLI option"
+  },
+  "Bun Test": {
+    "prefix": "test-desc",
+    "body": [
+      "describe('${1:test suite}', () => {",
+      "  it('${2:test case}', () => {",
+      "    $0",
+      "  });",
+      "});"
+    ],
+    "description": "Bun test describe block"
+  },
+  "Import Statement": {
+    "prefix": "imp",
+    "body": ["import { $1 } from '$2';"],
+    "description": "Import statement"
+  }
+}

package/AGENTS.md

@@ -0,0 +1,277 @@
+# OpenCode Configuration for ops-toolkit
+
+## Project Overview
+
+**Type**: Bun + TypeScript CLI toolkit  
+**Purpose**: DevOps CLI tool with terminal UI  
+**Tech Stack**: Bun, TypeScript, Commander, Chalk, OpenTUI  
+**Entry Point**: `src/index.ts`  
+**Debug Entry**: Use `bun --watch src/index.ts` for development, `tsx` for debugging
+
+## Essential Commands
+
+### Development
+
+```bash
+bun run dev          # Run in watch mode (use this for active development)
+bun run start        # Run once
+bun run build        # Build for production
+```
+
+### Code Quality
+
+```bash
+bun run lint         # Run ESLint
+bun run lint:fix     # Auto-fix linting issues
+bun run format       # Format code with Prettier
+bun run typecheck    # TypeScript type checking
+```
+
+### Testing
+
+```bash
+bun test             # Run all tests
+```
+
+### Git & Release
+
+```bash
+bun run release              # Create release with changelog
+bun run release:minor        # Minor version bump
+bun run release:major        # Major version bump
+```
+
+## Code Style & Conventions
+
+### Commit Message Format
+
+Must follow conventional commits:
+
+- `feat:` - New feature
+- `fix:` - Bug fix
+- `refactor:` - Code refactoring
+- `docs:` - Documentation changes
+- `style:` - Code style changes (formatting)
+- `test:` - Adding or updating tests
+- `chore:` - Maintenance tasks
+- `perf:` - Performance improvements
+
+**Note**: Commit messages are automatically linted. Body lines must be ≤72 characters.
+
+### Code Style
+
+- Use TypeScript strict mode
+- Follow ESLint rules (auto-fix available)
+- Use Prettier for formatting
+- No console.log in production code (use Logger utils when available)
+- Error handling with try-catch in async functions
+- Use chalk for colored terminal output
+
+### File Structure
+
+```
+src/
+├── index.ts          # Main CLI entry point
+├── commands/         # CLI command implementations
+├── components/       # UI components
+├── utils/            # Utility functions
+└── types/            # TypeScript type definitions
+```
+
+## Development Workflow
+
+### When Adding New Features
+
+1. Create command handler in `src/commands/`
+2. Add CLI command in `src/index.ts`
+3. Write tests (if applicable)
+4. Run `bun run typecheck` and `bun run lint`
+5. Test manually with `bun run dev`
+
+### When Fixing Bugs
+
+1. Identify the issue location
+2. Create a fix
+3. Run `bun run typecheck` and `bun run lint:fix`
+4. Test the fix manually
+
+### Debugging
+
+1. Use `ts-node` or `tsx` for debugging with VS Code
+2. Breakpoints can be set in `.ts` files directly
+3. Use F5 or the "Run and Debug" panel in VS Code
+4. The launch.json is configured for tsx debugging
+
+## Important Notes
+
+- **Never commit secrets or credentials**
+- **Always run lint:fix before committing** (handled automatically by husky)
+- **Use Bun as the runtime** (not Node)
+- **The bin entry is `bin/ops-toolkit.ts`** (not src/index.ts)
+- **TypeScript is configured with strict mode** - all types must be defined
+- **Husky pre-commit hooks run lint-staged** automatically
+
+## Common Tasks
+
+### Add a new CLI command
+
+```bash
+# 1. Create command file
+touch src/commands/mycommand/index.ts
+
+# 2. Implement the command handler
+# Follow existing command patterns
+
+# 3. Register in src/index.ts
+program
+  .command('mycommand')
+  .description('Description here')
+  .action(async () => {
+    // Implementation
+  });
+```
+
+### Add a new dependency
+
+```bash
+# Runtime dependency
+bun add <package>
+
+# Dev dependency
+bun add -d <package>
+```
+
+### Run type checking only
+
+```bash
+bun run typecheck
+```
+
+### Format all files
+
+```bash
+bun run format
+```
+
+## VS Code Shortcuts
+
+Recommended VS Code extensions:
+
+- Bun (oven.bun-vscode)
+- TypeScript (ms-vscode.vscode-typescript-next)
+- ESLint (ms-vscode.vscode-eslint)
+- Prettier (esbenp.prettier-vscode)
+
+Useful shortcuts:
+
+- `Cmd+Shift+B` - Build project
+- `F5` - Start debugging
+- `Cmd+Shift+F` - Format document
+- `Cmd+Shift+P` then "ESLint: Fix all auto-fixable Problems"
+
+## Testing Strategy
+
+Tests are run with `bun test`. When adding features:
+
+- Unit tests for utility functions
+- Integration tests for CLI commands
+- Test edge cases and error conditions
+
+## Performance Notes
+
+- Bun is used as runtime for performance
+- Avoid blocking operations in event loop
+- Use async/await for all I/O operations
+- Optimize large file operations
+
+## Error Handling Pattern
+
+Always handle errors in async operations:
+
+```typescript
+try {
+  // Your code here
+} catch (error) {
+  console.error(chalk.red('❌ Error:'), error);
+  process.exit(1);
+}
+```
+
+## Quick Reference
+
+| Task             | Command             |
+| ---------------- | ------------------- |
+| Start dev server | `bun run dev`       |
+| Build project    | `bun run build`     |
+| Run tests        | `bun test`          |
+| Type check       | `bun run typecheck` |
+| Lint and fix     | `bun run lint:fix`  |
+| Format code      | `bun run format`    |
+| Debug            | F5 in VS Code       |
+
+## OpenCode Custom Commands
+
+The project includes custom OpenCode commands for faster development. These commands are available in `.opencode/command/` directory:
+
+### Available Commands
+
+- `/add-cmd <name>` - Add a new CLI command
+- `/fix <issue>` - Fix code issues with automated checks
+- `/test` - Run and analyze test suite
+- `/release` - Prepare project for release
+- `/review <location>` - Review code changes
+- `/build` - Build and verify project
+- `/add-pkg <package>` - Add a new dependency
+- `/debug <issue>` - Get debugging help
+
+### Usage Examples
+
+```bash
+# Add a new command
+/add-cmd backup
+
+# Fix an issue
+/fix monitor command error
+
+# Run and analyze tests
+/test
+
+# Prepare for release
+/release
+
+# Review code
+/review src/utils/logger.ts
+
+# Build and verify
+/build
+
+# Add dependency
+/add-pkg axios
+
+# Get debugging help
+/debug async function not awaiting
+```
+
+### Documentation
+
+See `.opencode/README.md` for detailed documentation of all custom commands.
+
+### Creating Custom Commands
+
+To create your own commands:
+
+1. Create a `.md` file in `.opencode/command/`
+2. Use YAML frontmatter for configuration
+3. Use `$ARGUMENTS` for command arguments
+4. Use `!`command`` for shell output
+5. Use `@filename` for file references
+
+Example:
+
+```yaml
+---
+description: My custom command
+agent: build
+---
+My prompt template with $ARGUMENTS
+```

package/CHANGELOG.md

@@ -0,0 +1,24 @@
+# Changelog
+
+All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
+
+## 1.1.0 (2026-01-11)
+
+### Features
+
+- add comprehensive debugging setup ([6e56daa](https://github.com/username/ops-toolkit/commits/6e56daac18a80c49a1d3dd5a95e45a82054216f4))
+- add OpenCode custom commands for ops-toolkit ([228a2db](https://github.com/username/ops-toolkit/commits/228a2dbd58ea9c7f21db4ad94b4bad5c8ec53bb8))
+- initialize ops-toolkit CLI project ([b55190c](https://github.com/username/ops-toolkit/commits/b55190cbd81666b8893aab99ab24c5e264b81ce2))
+
+### Bug Fixes
+
+- add scripts directory to TypeScript include ([ce6324a](https://github.com/username/ops-toolkit/commits/ce6324a2cb0ce358419361d23910de32ec368648))
+
+### Code Refactoring
+
+- clean up debug code and add tsx support ([087b83d](https://github.com/username/ops-toolkit/commits/087b83d656fb3cf434bd6c6f458bd7bc32688970))
+
+### Documentation
+
+- add custom commands reference ([340cc12](https://github.com/username/ops-toolkit/commits/340cc12889d30b99a21334457e28e601a5fc2bb9))
+- add development guide with tips and tricks ([b8017af](https://github.com/username/ops-toolkit/commits/b8017affb22ff7448c897d47e4b3b57c548c80b1))

package/QUICKSTART.md

@@ -0,0 +1,136 @@
+# ops-toolkit - DevOps CLI Toolkit
+
+一个使用Bun、TypeScript和OpenTUI构建的综合DevOps CLI工具集。
+
+## 🚀 快速开始
+
+### 安装依赖
+
+```bash
+bun install
+```
+
+### 基本使用
+
+```bash
+# 运行默认命令
+bun bin/ops-toolkit.ts
+
+# 或者使用bun直接运行
+bun run start
+
+# 显示帮助
+bun bin/ops-toolkit.ts --help
+```
+
+## 📋 可用命令
+
+### 基础命令
+
+- `ops ui` - 启动交互式终端UI（默认）
+- `ops monitor` - 系统监控
+- `ops logs` - 日志管理
+- `ops deploy` - 部署工具
+- `ops system` - 系统管理
+
+### 监控命令
+
+- `ops monitor system` - 系统资源监控
+- `ops monitor processes` - 进程监控
+- `ops monitor network` - 网络监控
+- `ops monitor disk` - 磁盘使用监控
+
+### 日志命令
+
+- `ops logs view <file>` - 查看日志文件
+- `ops logs search <pattern>` - 搜索日志
+- `ops logs analyze <file>` - 日志分析
+- `ops logs export <file> <output>` - 导出日志
+
+### 部署命令
+
+- `ops deploy app <app>` - 部署应用
+- `ops deploy rollback <app>` - 回滚部署
+- `ops deploy status` - 部署状态
+- `ops deploy history` - 部署历史
+
+### 系统管理命令
+
+- `ops system users` - 用户管理
+- `ops system services` - 服务管理
+- `ops system config` - 配置管理
+- `ops system info` - 系统信息
+
+## 🛠️ 开发
+
+### 脚本命令
+
+```bash
+# 开发模式
+bun run dev
+
+# 构建项目
+bun run build
+
+# 类型检查
+bun run typecheck
+
+# 代码检查
+bun run lint
+
+# 自动修复代码格式
+bun run lint:fix
+
+# 代码格式化
+bun run format
+```
+
+### 项目结构
+
+```
+ops-toolkit/
+├── bin/                    # CLI入口文件
+│   └── ops-toolkit.ts
+├── src/
+│   ├── commands/           # 命令模块
+│   │   ├── monitor/       # 监控命令
+│   │   ├── logs/          # 日志命令
+│   │   ├── deploy/        # 部署命令
+│   │   └── system/        # 系统命令
+│   ├── types/              # TypeScript类型定义
+│   ├── utils/              # 工具函数
+│   └── index.ts           # 主入口
+├── scripts/               # 构建脚本
+├── docs/                  # 文档
+└── 配置文件...
+```
+
+## 🎯 特性
+
+- ✅ TypeScript支持
+- ✅ Bun包管理和运行时
+- ✅ ESLint + Prettier代码规范
+- ✅ Husky + lint-staged + commitlint Git工作流
+- ✅ Commander.js命令行解析
+- ✅ 彩色终端输出（chalk）
+- ✅ 模块化架构设计
+- 🚧 OpenTUI终端UI集成（开发中）
+
+## 📝 开发计划
+
+- [ ] 完整的OpenTUI界面实现
+- [ ] 系统监控功能
+- [ ] 日志管理功能
+- [ ] 部署工具功能
+- [ ] 系统管理功能
+- [ ] 配置文件管理
+- [ ] 插件系统
+- [ ] 单元测试
+
+## 📄 许可证
+
+MIT License
+
+## 🤝 贡献
+
+欢迎提交Issue和Pull Request！

package/README.md

@@ -0,0 +1,143 @@
+# ops-toolkit
+
+A comprehensive DevOps CLI toolkit with terminal UI built with Bun, TypeScript, and OpenTUI.
+
+## Features
+
+- 🔍 **System Monitoring** - Real-time CPU, memory, and disk usage
+- 📋 **Log Management** - View, search, and analyze logs
+- 🚀 **Deployment Tools** - Deploy applications with ease
+- ⚙️ **System Management** - User and service management
+- 🎨 **Terminal UI** - Beautiful interface with OpenTUI
+
+## Installation
+
+```bash
+# Install globally
+bun add -g ops-toolkit
+
+# Or use npx
+npx ops-toolkit
+```
+
+## Quick Start
+
+```bash
+# Start the interactive UI
+ops
+
+# Show system monitoring
+ops monitor
+
+# View logs
+ops logs
+
+# Deploy application
+ops deploy
+
+# System management
+ops system
+```
+
+## Commands
+
+### Monitor
+
+```bash
+ops monitor              # Show system monitoring dashboard
+ops monitor system      # System resources
+ops monitor processes   # Process monitoring
+ops monitor network     # Network monitoring
+```
+
+### Logs
+
+```bash
+ops logs                 # Interactive log viewer
+ops logs view <file>     # View specific log file
+ops logs search <query>  # Search logs
+ops logs tail <file>     # Tail log file
+```
+
+### Deploy
+
+```bash
+ops deploy               # Interactive deployment
+ops deploy <app>         # Deploy specific application
+ops deploy rollback      # Rollback deployment
+ops deploy status        # Check deployment status
+```
+
+### System
+
+```bash
+ops system               # System management menu
+ops system users         # User management
+ops system services      # Service management
+ops system config        # Configuration management
+```
+
+## Development
+
+```bash
+# Clone the repository
+git clone https://github.com/username/ops-toolkit.git
+cd ops-toolkit
+
+# Install dependencies
+bun install
+
+# Run in development mode
+bun run dev
+
+# Build the project
+bun run build
+
+# Run tests
+bun test
+
+# Lint code
+bun run lint
+
+# Format code
+bun run format
+```
+
+## Configuration
+
+Configuration files are located in `~/.ops-toolkit/`:
+
+```json
+{
+  "monitor": {
+    "refreshInterval": 1000,
+    "showProcesses": true
+  },
+  "logs": {
+    "defaultPath": "/var/log",
+    "maxLines": 1000
+  },
+  "deploy": {
+    "defaultEnv": "production",
+    "backupEnabled": true
+  }
+}
+```
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'feat: add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Acknowledgments
+
+- Built with [Bun](https://bun.sh/)
+- UI powered by [OpenTUI](https://opentui.dev/)
+- Inspired by modern DevOps tools