Harlequin
The SQL IDE for Your Terminal.
  • Get Started
  • Docs
  • Blog
  • About
  • Sponsor
  • GitHub icon
    tconbeer/harlequin
    GitHub stars6,368Ā GitHub forks170
  • Getting Started
    • Installing Harlequin
    • Running Harlequin
    • Using Harlequin
    • Using hsql
    • Getting Help
  • The hsql CLI
    • hsql Overview
    • Exit Codes and Streams
    • Exploring the Catalog
    • Formats and Layouts
    • Config Modes
    • Running Safely
    • Differences from psql
    • Reference: hsql CLI
    • The hsql Agent Skill
  • Agent Docs
  • Database Adapters
    • Adapters Overview
    • Adapter: DuckDB
      • DuckDB Basic Usage
      • Initialization Scripts
      • Loading Extensions
      • Transaction Handling
      • MotherDuck
    • Adapter: SQLite
      • SQLite Basic Usage
      • Initialization Scripts
      • Loading Extensions
      • Transaction Handling
    • Adapter: Postgres
      • Postgres Basic Usage
      • Multiple Databases
      • Transaction Handling
    • Adapter: Redshift
      • Redshift Basic Usage
      • Redshift Authentication
      • Redshift Data Catalog
    • Adapter: Snowflake
      • Snowflake Basic Usage
      • Snowflake Authentication
    • Adapter: MySQL/MariaDB
    • Adapter: ODBC
    • Adapter: BigQuery
      • BQ Installation and Configuration
      • Auth and Permissions
    • Adapter: Trino
    • Adapter: Databricks
      • Installation and Basic Usage
      • Initialization Scripts
    • Adapter: ADBC
    • Adapter: RisingWave
    • Adapter: Wherobots
    • Adapter: Cassandra
    • Adapter: NebulaGraph
    • Adapter: Exasol
    • Adapter: H2
  • Configuring Harlequin
    • Config Overview
    • Creating Config Files
    • Discovering Config Files
    • Selecting a Profile
  • SSH Tunnels
    • SSH Tunnels Overview
    • SSH Configuration
    • SSH Security
    • Troubleshooting SSH
  • Viewing Files
    • Files Overview
    • Local Files
    • Remote Objects (S3)
  • Choosing a Theme
  • Customizing Key Bindings
    • About Key Bindings
    • Creating a Keymap
    • Selecting Keymaps
  • Exporting Data
  • Managing Transactions
  • Reference: Default Bindings
  • Troubleshooting
    • Common Problems
    • Key Bindings
    • Copying and Pasting
    • Appearance
    • Locale
    • Windows Timezone Database
    • DuckDB Version Mismatch
    • Terminal Recommendations
  • Contributing to Harlequin
    • Ways to Contribute
    • Creating an Adapter

Common Problems

View as Markdown

Sorry to see you here. Terminals can be finicky.

Common Problems

  1. Key Bindings
  2. Copy-Paste
  3. Appearance (Colors and Fonts)
  4. Locale (Number formatting)
  5. Windows Timezone Database
  6. DuckDB Version Mismatch

While Harlequin aims to work in every terminal, some do provide better support for Harlequin’s features. Our recommended terminals can be found here.

← Previous

Reference: Default Bindings

Next →

Key Bindings

  • Docs
  • Blog
  • About
  • GitHub

Shandy Data LLC ©2026. Icons by Icons8.