apex-ai 0.1.0__tar.gz

apex_ai-0.1.0/.github/FUNDING.yml

@@ -0,0 +1,6 @@
+github: ggboykxz
+open_collective: apex-agent
+ko_fi: ggboykxz
+custom:
+  - https://apex-agent.dev/sponsors
+  - https://github.com/sponsors/ggboykxz

apex_ai-0.1.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,89 @@
+name: Bug report
+description: Report a reproducible defect in APEX
+title: "[Bug]: "
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to report a bug. Please search existing issues first.
+        For security vulnerabilities, do **not** open a public issue — follow `SECURITY.md`.
+
+  - type: textarea
+    id: what-happened
+    attributes:
+      label: What happened?
+      description: A clear and concise description of the defect.
+      placeholder: When I run `apex ...`, ...
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected behavior
+      description: What did you expect to happen instead?
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Steps to reproduce
+      description: Minimal, deterministic steps.
+      placeholder: |
+        1. Install APEX ...
+        2. Run `apex ...`
+        3. Observe ...
+    validations:
+      required: true
+
+  - type: input
+    id: version
+    attributes:
+      label: APEX version
+      description: Output of `apex --version`.
+      placeholder: 2.0.0
+    validations:
+      required: true
+
+  - type: dropdown
+    id: surface
+    attributes:
+      label: Surface
+      options:
+        - CLI / Python backend
+        - TUI (tui-frontend)
+        - Rust port (apex-rs)
+        - Website / docs
+        - CI / tooling
+    validations:
+      required: true
+
+  - type: input
+    id: environment
+    attributes:
+      label: Environment
+      description: OS, Python version, terminal.
+      placeholder: Windows 11, Python 3.12, Windows Terminal
+    validations:
+      required: true
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: Relevant logs
+      description: Paste logs with secrets removed. Never include API keys or tokens.
+      render: shell
+    validations:
+      required: false
+
+  - type: checkboxes
+    id: checks
+    attributes:
+      label: Checklist
+      options:
+        - label: I searched existing issues and this is not a duplicate.
+          required: true
+        - label: I removed API keys, tokens, and other secrets from logs.
+          required: true

apex_ai-0.1.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,11 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Security vulnerability
+    url: https://github.com/Ggboykxz/APEX/security/advisories/new
+    about: Report vulnerabilities privately. Do not open a public issue.
+  - name: Documentation
+    url: https://apex-ai.dev/docs
+    about: Installation, configuration, tools, and guides.
+  - name: Public roadmap
+    url: https://apex-ai.dev/roadmap
+    about: See what is shipped and what is planned for v2.5.

apex_ai-0.1.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,72 @@
+name: Feature request
+description: Propose a capability or improvement for APEX
+title: "[Feature]: "
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for the suggestion. Please check the public roadmap first:
+        https://apex-ai.dev/roadmap
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: What user problem does this solve? Who is affected?
+    validations:
+      required: true
+
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed solution
+      description: Describe the behavior you would like, including CLI/TUI/API surface.
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+      description: Existing workarounds or other designs you evaluated.
+    validations:
+      required: false
+
+  - type: dropdown
+    id: area
+    attributes:
+      label: Area
+      options:
+        - CLI / Python backend
+        - TUI (tui-frontend)
+        - Rust port (apex-rs)
+        - Website / docs
+        - Integrations (MCP, VS Code)
+        - CI / tooling
+    validations:
+      required: true
+
+  - type: dropdown
+    id: milestone
+    attributes:
+      label: Roadmap alignment
+      options:
+        - v2.5 M1 — Repository Map & Context
+        - v2.5 M2 — Rust GA (internal)
+        - v2.5 M3 — TUI Streaming & Diff
+        - v2.5 M4 — MCP, Vision, VS Code
+        - Post-v2.5
+        - Not sure
+    validations:
+      required: true
+
+  - type: checkboxes
+    id: checks
+    attributes:
+      label: Checklist
+      options:
+        - label: I searched existing issues and this is not a duplicate.
+          required: true
+        - label: I checked the public roadmap.
+          required: true

apex_ai-0.1.0/.github/dependabot.yml

@@ -0,0 +1,112 @@
+# Dependabot configuration for APEX
+# Auto dependency updates across all ecosystems
+
+version: 2
+
+updates:
+  # Python pip dependencies
+  - package-ecosystem: pip
+    directory: /
+    schedule:
+      interval: weekly
+      day: monday
+      time: "06:00"
+      timezone: UTC
+    open-pull-requests-limit: 10
+    reviewers:
+      - Ggboykxz
+    labels:
+      - dependencies
+      - python
+    commit-message:
+      prefix: chore
+      prefix-development: chore
+      include: scope
+    rebase-strategy: auto
+
+  # npm dependencies — Next.js frontend (src/)
+  - package-ecosystem: npm
+    directory: /
+    schedule:
+      interval: weekly
+      day: monday
+      time: "06:00"
+      timezone: UTC
+    open-pull-requests-limit: 10
+    reviewers:
+      - Ggboykxz
+    labels:
+      - dependencies
+      - website
+    commit-message:
+      prefix: chore
+      prefix-development: chore
+      include: scope
+    rebase-strategy: auto
+    ignore:
+      - dependency-name: "next"
+        update-types: [version-update:semver-major]
+      - dependency-name: "react"
+      - dependency-name: "react-dom"
+      - dependency-name: "typescript"
+      - dependency-name: "eslint"
+
+  # npm dependencies — TUI frontend (tui-frontend/)
+  - package-ecosystem: npm
+    directory: /tui-frontend
+    schedule:
+      interval: weekly
+      day: monday
+      time: "06:00"
+      timezone: UTC
+    open-pull-requests-limit: 10
+    reviewers:
+      - Ggboykxz
+    labels:
+      - dependencies
+      - tui
+    commit-message:
+      prefix: chore
+      prefix-development: chore
+      include: scope
+    rebase-strategy: auto
+
+  # GitHub Actions
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly
+      day: monday
+      time: "06:00"
+      timezone: UTC
+    open-pull-requests-limit: 10
+    reviewers:
+      - Ggboykxz
+    labels:
+      - dependencies
+      - ci
+    commit-message:
+      prefix: ci
+      prefix-development: ci
+      include: scope
+    rebase-strategy: auto
+
+  # Docker base images
+  - package-ecosystem: docker
+    directory: /
+    schedule:
+      interval: weekly
+      day: monday
+      time: "06:00"
+      timezone: UTC
+    open-pull-requests-limit: 10
+    reviewers:
+      - Ggboykxz
+    labels:
+      - dependencies
+      - docker
+    commit-message:
+      prefix: chore
+      prefix-development: chore
+      include: scope
+    rebase-strategy: auto

apex_ai-0.1.0/.github/labeler.yml

@@ -0,0 +1,53 @@
+# Auto-label configuration for APEX PRs
+# Used by actions/labeler@v5
+
+python:
+  - changed-files:
+      - any-glob-to-any-file:
+          - apex/**
+          - tests/**
+          - "*.py"
+          - pyproject.toml
+          - requirements.txt
+
+website:
+  - changed-files:
+      - any-glob-to-any-file:
+          - src/**
+          - public/**
+          - package.json
+          - bun.lock
+          - tailwind.config.ts
+          - next.config.ts
+          - tsconfig.json
+          - eslint.config.mjs
+          - postcss.config.mjs
+          - components.json
+
+tui:
+  - changed-files:
+      - any-glob-to-any-file:
+          - tui-frontend/**
+          - tui-frontend/package.json
+          - tui-frontend/tsconfig.json
+
+docs:
+  - changed-files:
+      - any-glob-to-any-file:
+          - docs/**
+          - "*.md"
+          - mkdocs.yml
+
+ci:
+  - changed-files:
+      - any-glob-to-any-file:
+          - .github/**
+          - .github/workflows/**
+          - .github/dependabot.yml
+
+docker:
+  - changed-files:
+      - any-glob-to-any-file:
+          - Dockerfile
+          - docker-compose*
+          - .dockerignore

apex_ai-0.1.0/.github/release-drafter.yml

@@ -0,0 +1,129 @@
+# Release Drafter configuration for APEX
+
+name-template: "v$RESOLVED_VERSION"
+tag-template: "v$RESOLVED_VERSION"
+template: |
+  ## APEX v$RESOLVED_VERSION
+
+  The universal AI coding agent. Every model. One terminal.
+
+  ### Changes
+
+  $CHANGES
+
+  ### Installation
+
+  ```bash
+  # pip (recommended)
+  pip install apex-ai==$RESOLVED_VERSION
+
+  # pipx (isolated)
+  pipx install apex-ai==$RESOLVED_VERSION
+
+  # uv (fastest)
+  uv tool install apex-ai==$RESOLVED_VERSION
+
+  # Installer (macOS/Linux)
+  curl -fsSLO https://apex-ai.dev/install.sh
+  bash install.sh
+
+  # Installer (Windows PowerShell)
+  Invoke-WebRequest https://apex-ai.dev/install.ps1 -OutFile install.ps1
+  powershell -ExecutionPolicy Bypass -File .\install.ps1
+  ```
+
+  ### Native backend (headless, opt-in)
+
+  Verified release assets ship for Linux (x86_64/aarch64), macOS
+  (x86_64/aarch64) and Windows (x86_64), each with a `.sha256` sidecar:
+
+  ```bash
+  bash install.sh --method native --version $RESOLVED_VERSION
+  ```
+
+  ### Docker
+
+  ```bash
+  docker pull ghcr.io/ggboykxz/apex:$RESOLVED_VERSION
+  docker run -it -v $(pwd):/workspace ghcr.io/ggboykxz/apex
+  ```
+
+  ### Quick Start
+
+  ```bash
+  export ANTHROPIC_API_KEY=sk-ant-...
+  apex                          # Interactive mode
+  apex --model gpt-4o           # Start with GPT-4o
+  apex --model ollama-llama3    # Local, no API key
+  ```
+
+  **Full Changelog**: https://github.com/Ggboykxz/APEX/compare/$PREVIOUS_TAG...v$RESOLVED_VERSION
+
+categories:
+  - title: "🚀 Features"
+    labels:
+      - feature
+      - enhancement
+      - feat
+  - title: "🐛 Bug Fixes"
+    labels:
+      - bug
+      - fix
+      - bugfix
+  - title: "📚 Documentation"
+    labels:
+      - documentation
+      - docs
+  - title: "♻️ Refactoring"
+    labels:
+      - refactor
+      - refactoring
+  - title: "⚡ Performance"
+    labels:
+      - perf
+      - performance
+  - title: "🧪 Tests"
+    labels:
+      - test
+      - tests
+  - title: "🔧 CI/CD"
+    labels:
+      - ci
+      - build
+  - title: "🎫 Chores"
+    labels:
+      - chore
+      - dependencies
+  - title: "🔒 Security"
+    labels:
+      - security
+
+label-template: "$TITLE @$AUTHOR (#$NUMBER)"
+
+change-template: "- $TITLE @$AUTHOR (#$NUMBER)"
+change-title-escapes: '\<*_&'
+
+version-resolver:
+  major:
+    labels:
+      - breaking
+      - major
+  minor:
+    labels:
+      - feature
+      - enhancement
+      - feat
+  patch:
+    labels:
+      - bug
+      - fix
+      - bugfix
+      - security
+      - chore
+      - dependencies
+  default: patch
+
+exclude-labels:
+  - skip-changelog
+  - stale
+  - wontfix

apex_ai-0.1.0/.github/workflows/audit.yml

@@ -0,0 +1,60 @@
+name: Dependency Audit
+
+on:
+  schedule:
+    - cron: "0 5 * * 1"  # Every Monday at 05:00 UTC
+  workflow_dispatch:
+  push:
+    branches: [main]
+    paths:
+      - "package.json"
+      - "package-lock.json"
+      - "tui-frontend/package.json"
+      - "tui-frontend/package-lock.json"
+      - "requirements.txt"
+      - "pyproject.toml"
+      - ".github/workflows/audit.yml"
+
+permissions:
+  contents: read
+
+jobs:
+  audit:
+    name: Audit dependencies
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: actions/setup-node@v6
+        with:
+          node-version: "24"
+          cache: npm
+          cache-dependency-path: |
+            package-lock.json
+            tui-frontend/package-lock.json
+
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+          cache: pip
+          cache-dependency-path: requirements.txt
+
+      - name: npm audit (website)
+        run: npm audit --omit=dev
+        continue-on-error: true
+
+      - name: npm audit (TUI)
+        working-directory: tui-frontend
+        run: npm audit --omit=dev
+        continue-on-error: true
+
+      - name: Install pip-audit
+        run: pip install pip-audit
+
+      - name: pip-audit (requirements)
+        run: pip-audit -r requirements.txt
+        continue-on-error: true
+
+      - name: pip-audit (pyproject)
+        run: pip-audit -r <(python -c "import tomllib, pathlib; d=tomllib.loads(pathlib.Path('pyproject.toml').read_text()); print('\n'.join(d['project']['dependencies']))")
+        continue-on-error: true

apex_ai-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,137 @@
+name: CI
+
+on:
+  push:
+    branches: [main, dev]
+  pull_request:
+    branches: [main]
+  merge_group:
+
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    name: Lint (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install ruff==0.9.10 mypy
+          pip install -e ".[dev]" || pip install -e .
+
+      - name: Ruff lint
+        run: ruff check apex/ tests/ --output-format=github
+
+      - name: Ruff format check
+        run: ruff format --check apex/ tests/
+
+      - name: Type check
+        run: mypy apex/ --ignore-missing-imports
+        continue-on-error: true
+
+  test:
+    name: Test (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]" || pip install -e .
+
+      - name: Run tests
+        run: pytest --tb=short -q --junitxml=test-results.xml
+        env:
+          CI: "true"
+
+      - name: Test summary
+        if: always()
+        run: |
+          echo "=== Test Results ==="
+          if [ -f test-results.xml ]; then
+            echo "Test results generated"
+          else
+            echo "Warning: No test results file"
+          fi
+
+      - name: Upload test results
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: test-results-py${{ matrix.python-version }}
+          path: test-results.xml
+
+  rust:
+    name: Rust (fmt, clippy, test)
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: rust/apex-rs
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          components: rustfmt, clippy
+
+      - name: Cache cargo
+        uses: actions/cache@v6
+        with:
+          path: |
+            ~/.cargo/registry
+            ~/.cargo/git
+            rust/apex-rs/target
+          key: ${{ runner.os }}-cargo-${{ hashFiles('rust/apex-rs/Cargo.lock') }}
+          restore-keys: ${{ runner.os }}-cargo-
+
+      - name: Format check
+        run: cargo fmt --all -- --check
+
+      - name: Clippy
+        run: cargo clippy --all-targets -- -D warnings
+
+      - name: Tests
+        run: cargo test
+
+  build-check:
+    name: Build check (sdist + wheel)
+    runs-on: ubuntu-latest
+    needs: [lint, test, rust]
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+
+      - name: Build package
+        run: |
+          pip install build twine
+          python -m build
+
+      - name: Check package
+        run: twine check dist/*