AgentToolHub
Skill

typescript-type-expert

typescript-type-expert — a Claude Code skill from cin12211/orca-q

Features

  • ✓🖥️ **Modern UI/UX**: Minimalist interface with dark mode support, drag & drop, and flexible sidebar.
  • ✓⚡ **Quick Query**: Fast data querying with preview, filtering, and dynamic field search.
  • ✓📝 **Raw SQL Editor**: Write and execute SQL queries with multiple layout modes (vertical/horizontal).
  • ✓🗂️ **Explorer**: Browse database structures, tables, schemas, and files.
  • ✓🔒 **Workspace & Connection Management**: Manage multiple connections and independent workspaces.
  • ✓🛠️ **Hotkey Support**: Supports shortcuts for faster operations.
  • ✓🍎 **Desktop App for macOS**: Currently in development.

Installation Guide

Requirements

  • Node.js >= 18.x

  • pnpm or bun

  • macOS, Windows, or Linux

    • Steps (Web setup)

  • Clone the repository:

    • sh
       git clone https://github.com/cin12211/orca-q.git
   cd orcaq

  • Install dependencies:

    • sh
       bun install

  • Run in development mode:

    • sh
       npm run nuxt:dev

  • Build for production:

    • sh
       npm run nuxt:build

    NPX Setup

    Run OrcaQ directly with npx if you do not want to clone the repository or build Docker images.

  • Run OrcaQ:

    • sh
       npx orcaq

    Requires Node.js >= 18. By default OrcaQ starts on http://localhost:9432 and opens your browser automatically.

    Docker Setup

    Run OrcaQ instantly with Docker — no local Node.js or build tools required.

    #### Guide 1 — Run with the published Docker image

    Use the prebuilt image if you just want to start OrcaQ quickly.

  • Pull the image:

    • sh
       docker pull cinny09/orcaq:latest

  • Run the container:

    • sh
       docker run -d \
     --name orcaq \
     --restart unless-stopped \
     -p 9432:9432 \
     cinny09/orcaq:latest

  • Open OrcaQ:

    • Visit http://localhost:9432

    Note: If you are still using the old image name cinny09/orca-q, switch to cinny09/orcaq.

    #### Guide 2 — Build locally with Docker Compose

    Use this if you want to build the image from the current source code.

  • Clone the repository:

    • sh
       git clone https://github.com/cin12211/orca-q.git
   cd orcaq

  • Configure environment (optional):

    • sh
       cp .env.example .env
   # Default Docker port is 9432
   # Edit .env if you want to change it

  • Start with Docker Compose:

    • sh
       docker compose up -d --build orcaq

  • Open OrcaQ:

    • Visit http://localhost:9432

    Note: The demo PostgreSQL service is currently commented out in docker-compose.yml. OrcaQ is stateless — it connects to your databases at runtime. If you want a local demo database, uncomment the postgres-demo service first.

    Reviews