o2-cli 0.1.0__tar.gz

o2_cli-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dylan Wu
+
+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.

o2_cli-0.1.0/PKG-INFO

@@ -0,0 +1,141 @@
+Metadata-Version: 2.4
+Name: o2-cli
+Version: 0.1.0
+Summary: CLI for O2 DEX Trading Platform
+Author: Dylan Wu
+License-Expression: MIT
+Keywords: cli,trading,dex,lighter,o2
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Office/Business :: Financial :: Investment
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer[all]>=0.9.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: prompt-toolkit>=3.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: respx>=0.20.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Dynamic: license-file
+
+# O2 CLI
+
+Command-line interface for [O2 DEX](https://github.com/dylanwu19850222/lighter-dex) Trading Platform.
+
+## Install
+
+```bash
+pip install o2-cli
+```
+
+## Quick Start
+
+```bash
+# Login (dev environment)
+o2 auth test-login
+
+# View markets (public, no login needed)
+o2 --json markets list
+
+# Check balance
+o2 --json balance show
+
+# Place a market order (long 0.001 BTC)
+o2 --json orders create -m 1 -s long -t market -a 0.001
+
+# View positions
+o2 --json positions list
+```
+
+## Vibe Coding Tool Setup
+
+After installing, run the setup wizard to install skill files for your AI coding tool:
+
+```bash
+# Interactive wizard
+o2 setup
+
+# Non-interactive
+o2 setup --tool claude-code --scope global
+o2 setup --tool cursor --scope project
+
+# Update all installed tools
+o2 setup --update
+```
+
+Supported tools: **Claude Code**, **Cursor**, **Codex (OpenAI)**, **Windsurf**, **Cline**, **Trae**
+
+## Key Rules
+
+1. `--json` must come before the subcommand: `o2 --json balance show` (not `o2 balance show --json`)
+2. Public commands (no login): `markets list`, `fees rates`
+3. Other commands require `o2 auth test-login` first
+4. Exit codes: 0 = success, 1 = error
+
+## Commands
+
+| Group | Commands | Auth Required |
+|-------|----------|---------------|
+| `auth` | `test-login`, `me`, `session` | No (login) |
+| `markets` | `list`, `orderbook`, `candles`, `trades` | No |
+| `fees` | `rates`, `estimate` | No |
+| `balance` | `show`, `history` | Yes |
+| `orders` | `create`, `list`, `cancel`, `cancel-all`, `modify`, `batch` | Yes |
+| `positions` | `list`, `market`, `close`, `risk` | Yes |
+| `trades` | `list`, `summary` | Yes |
+| `deposits` | `address`, `history` | Yes |
+| `withdrawals` | `create`, `status`, `cancel`, `list` | Yes |
+| `settings` | `get`, `leverage`, `margin-mode` | Yes |
+| `notifications` | `list`, `unread`, `read` | Yes |
+| `account` | `overview` | Yes |
+| `mm` | `status`, `start`, `stop`, `stats`, `orders` | API Key |
+| `admin` | `gas-status`, `proxy-list`, `api-keys`, `reconcile` | Admin JWT |
+| `setup` | wizard, `--tool`, `--update`, `--status` | No |
+
+## Configuration
+
+Config file: `~/.o2/config.yaml`
+
+```yaml
+active_profile: default
+profiles:
+  default:
+    api_url: http://localhost:8000/api/v1
+    timeout: 30
+    auth_type: jwt
+    token: eyJ...  # auto-saved
+```
+
+Override at runtime:
+```bash
+o2 --profile production --json balance show
+o2 --api-url https://api.example.com/api/v1 --json markets list
+```
+
+## Development
+
+```bash
+git clone https://github.com/dylanwu19850222/o2-cli.git
+cd o2-cli
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+
+# Lint
+ruff check o2_cli/
+```
+
+## License
+
+MIT

o2_cli-0.1.0/README.md

@@ -0,0 +1,111 @@
+# O2 CLI
+
+Command-line interface for [O2 DEX](https://github.com/dylanwu19850222/lighter-dex) Trading Platform.
+
+## Install
+
+```bash
+pip install o2-cli
+```
+
+## Quick Start
+
+```bash
+# Login (dev environment)
+o2 auth test-login
+
+# View markets (public, no login needed)
+o2 --json markets list
+
+# Check balance
+o2 --json balance show
+
+# Place a market order (long 0.001 BTC)
+o2 --json orders create -m 1 -s long -t market -a 0.001
+
+# View positions
+o2 --json positions list
+```
+
+## Vibe Coding Tool Setup
+
+After installing, run the setup wizard to install skill files for your AI coding tool:
+
+```bash
+# Interactive wizard
+o2 setup
+
+# Non-interactive
+o2 setup --tool claude-code --scope global
+o2 setup --tool cursor --scope project
+
+# Update all installed tools
+o2 setup --update
+```
+
+Supported tools: **Claude Code**, **Cursor**, **Codex (OpenAI)**, **Windsurf**, **Cline**, **Trae**
+
+## Key Rules
+
+1. `--json` must come before the subcommand: `o2 --json balance show` (not `o2 balance show --json`)
+2. Public commands (no login): `markets list`, `fees rates`
+3. Other commands require `o2 auth test-login` first
+4. Exit codes: 0 = success, 1 = error
+
+## Commands
+
+| Group | Commands | Auth Required |
+|-------|----------|---------------|
+| `auth` | `test-login`, `me`, `session` | No (login) |
+| `markets` | `list`, `orderbook`, `candles`, `trades` | No |
+| `fees` | `rates`, `estimate` | No |
+| `balance` | `show`, `history` | Yes |
+| `orders` | `create`, `list`, `cancel`, `cancel-all`, `modify`, `batch` | Yes |
+| `positions` | `list`, `market`, `close`, `risk` | Yes |
+| `trades` | `list`, `summary` | Yes |
+| `deposits` | `address`, `history` | Yes |
+| `withdrawals` | `create`, `status`, `cancel`, `list` | Yes |
+| `settings` | `get`, `leverage`, `margin-mode` | Yes |
+| `notifications` | `list`, `unread`, `read` | Yes |
+| `account` | `overview` | Yes |
+| `mm` | `status`, `start`, `stop`, `stats`, `orders` | API Key |
+| `admin` | `gas-status`, `proxy-list`, `api-keys`, `reconcile` | Admin JWT |
+| `setup` | wizard, `--tool`, `--update`, `--status` | No |
+
+## Configuration
+
+Config file: `~/.o2/config.yaml`
+
+```yaml
+active_profile: default
+profiles:
+  default:
+    api_url: http://localhost:8000/api/v1
+    timeout: 30
+    auth_type: jwt
+    token: eyJ...  # auto-saved
+```
+
+Override at runtime:
+```bash
+o2 --profile production --json balance show
+o2 --api-url https://api.example.com/api/v1 --json markets list
+```
+
+## Development
+
+```bash
+git clone https://github.com/dylanwu19850222/o2-cli.git
+cd o2-cli
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+
+# Lint
+ruff check o2_cli/
+```
+
+## License
+
+MIT

o2_cli-0.1.0/o2_cli/__init__.py

@@ -0,0 +1,30 @@
+"""O2 CLI - Command-line interface for O2 DEX Trading Platform."""
+
+from pathlib import Path
+
+__version__ = "0.1.0"
+
+
+def ensure_skill_installed() -> bool:
+    """自动安装 Claude Code Skill 到 ~/.claude/skills/o2-cli/。
+
+    首次运行 o2 命令时检查并安装。不覆盖已有文件（用户可能自定义过）。
+
+    Returns:
+        True 如果 skill 已存在或刚安装成功，False 如果安装失败。
+    """
+    skill_dir = Path.home() / ".claude" / "skills" / "o2-cli"
+    skill_file = skill_dir / "SKILL.md"
+
+    if skill_file.exists():
+        return True
+
+    try:
+        from o2_cli.setup import SKILL_CONTENT
+
+        skill_dir.mkdir(parents=True, exist_ok=True)
+        skill_file.write_text(SKILL_CONTENT, encoding="utf-8")
+        return True
+    except OSError:
+        # 权限不足或其他 IO 错误，静默失败不影响 CLI 使用
+        return False

o2_cli-0.1.0/o2_cli/__main__.py

@@ -0,0 +1,6 @@
+"""Support `python -m o2_cli`."""
+
+from o2_cli.cli import app
+
+if __name__ == "__main__":
+    app()

o2_cli-0.1.0/o2_cli/cli.py

@@ -0,0 +1,94 @@
+"""O2 CLI root - Typer application with global options."""
+
+import asyncio
+import typing as t
+from typing import Optional
+
+import typer
+
+from o2_cli import __version__, ensure_skill_installed
+
+app = typer.Typer(
+    name="o2",
+    help="O2 DEX Trading Platform CLI",
+    no_args_is_help=True,
+    rich_markup_mode="rich",
+)
+
+
+def version_callback(value: bool):
+    if value:
+        typer.echo(f"o2-cli version {__version__}")
+        raise typer.Exit()
+
+
+@app.callback()
+def main(
+    json_output: bool = typer.Option(False, "--json", help="Output raw JSON"),
+    config: Optional[str] = typer.Option(None, "--config", help="Config file path"),
+    profile: Optional[str] = typer.Option(None, "--profile", help="Config profile"),
+    api_url: Optional[str] = typer.Option(None, "--api-url", help="Override API URL"),
+    timeout: float = typer.Option(30.0, "--timeout", help="HTTP timeout in seconds"),
+    verbose: bool = typer.Option(False, "-v", "--verbose", help="Verbose logging"),
+    version: bool = typer.Option(False, "--version", callback=version_callback, is_eager=True),
+):
+    """O2 DEX Trading Platform CLI."""
+    # Auto-install Claude Code skill on first run
+    ensure_skill_installed()
+    # Store global state for commands to access
+    app.state = {
+        "json_output": json_output,
+        "config_path": config,
+        "profile": profile,
+        "api_url": api_url,
+        "timeout": timeout,
+        "verbose": verbose,
+    }
+
+
+def get_state() -> dict:
+    """Get global CLI state."""
+    return getattr(app, "state", {
+        "json_output": False,
+        "config_path": None,
+        "profile": None,
+        "api_url": None,
+        "timeout": 30.0,
+        "verbose": False,
+    })
+
+
+# Register command groups
+from o2_cli.commands import (  # noqa: E402
+    auth,
+    balance,
+    orders,
+    positions,
+    markets,
+    trades,
+    fees,
+    deposits,
+    withdrawals,
+    settings,
+    notifications,
+    account,
+    admin,
+    mm,
+    setup_cmd,
+)
+
+app.add_typer(auth.app, name="auth", help="Authentication")
+app.add_typer(balance.app, name="balance", help="Balance queries")
+app.add_typer(orders.app, name="orders", help="Order management")
+app.add_typer(positions.app, name="positions", help="Position management")
+app.add_typer(markets.app, name="markets", help="Market data")
+app.add_typer(trades.app, name="trades", help="Trade history")
+app.add_typer(fees.app, name="fees", help="Fee information")
+app.add_typer(deposits.app, name="deposits", help="Deposit management")
+app.add_typer(withdrawals.app, name="withdrawals", help="Withdrawal management")
+app.add_typer(settings.app, name="settings", help="User settings")
+app.add_typer(notifications.app, name="notifications", help="Notifications")
+app.add_typer(account.app, name="account", help="Account overview")
+app.add_typer(admin.app, name="admin", help="Admin operations")
+app.add_typer(mm.app, name="mm", help="Market maker control")
+app.add_typer(setup_cmd.app, name="setup", help="Setup for vibe coding tools")