Describe the bug
When using kitten quick-access-terminal with edge=none on macOS, increasing margin_top beyond a certain threshold causes the panel to keep moving down correctly, but its height also starts shrinking at the same time — as if the bottom edge of the panel is being clipped to a fixed position on screen, so increasing margin_top eats into the panel's height instead of purely translating it.
This makes it impossible to anchor a fixed-size panel to the bottom-left corner of the screen using edge=none + margin_top, as documented, once the desired margin_top exceeds whatever this internal threshold is.
To Reproduce
Steps to reproduce the behavior:
- Run:
kitten quick-access-terminal --config NONE -o edge=none -o columns=1800px -o lines=1169px -o margin_left=0 -o margin_top=0
The panel appears at the top-left, correctly sized at 1800x1169.
- Kill it, then run again with
-o margin_top=300.
The panel moves down, but its height is now visibly shorter than 1169.
- Kill it, then run again with
-o margin_top=400.
The panel moves further down, and the height shrinks even more.
Expected behavior
As long as margin_top + lines fits within the screen height, the panel should stay at its configured size (lines/columns) and simply translate down by margin_top pixels. Shrinking the panel would only make sense once margin_top + lines actually exceeds the screen height — which is not the case in this reproduction.
Screenshots
Environment details
kitty 0.48.0 (5b4ea1bbba) created by Kovid Goyal
Darwin funasoulM4.local 25.5.0 Darwin Kernel Version 25.5.0: Mon Apr 27 20:41:15 PDT 2026; root:xnu-12377.121.6~2/RELEASE_ARM64_T6041 arm64
ProductName: macOS ProductVersion: 26.5.1 BuildVersion: 25F80
OpenGL: '4.1 Metal - 90.5' Detected version: 4.1
Frozen: True
Fonts:
medium: Menlo-Regular: /System/Library/Fonts/Menlo.ttc
Features: ()
bold: Menlo-Bold: /System/Library/Fonts/Menlo.ttc
Features: ()
italic: Menlo-Italic: /System/Library/Fonts/Menlo.ttc
Features: ()
bi: Menlo-BoldItalic: /System/Library/Fonts/Menlo.ttc
Features: ()
Paths:
kitty: /Applications/kitty.app/Contents/MacOS/kitty
base dir: /Applications/kitty.app/Contents/kitty-quick-access.app/Contents/Resources/kitty
extensions dir: /Applications/kitty.app/Contents/kitty-quick-access.app/Contents/Resources/Python/lib/kitty-extensions
system shell: /bin/zsh
System color scheme: dark. Applied color theme type: none
Loaded config overrides:
background_opacity 0.850000
linux_display_server auto
macos_quit_when_last_window_closed yes
macos_hide_from_tasks yes
macos_window_resizable no
Config options different from defaults:
background_opacity 0.85
macos_hide_from_tasks True
macos_quit_when_last_window_closed True
macos_window_resizable False
Changed shortcuts:
cmd+k → clear_terminal_and_scrollback
cmd+l → clear_last_command
ctrl+cmd+, → reload_config
ctrl+cmd+l → clear_screen
opt+cmd+k → clear_scrollback
opt+cmd+r → reset_terminal
shift+cmd+/ → open_kitty_website
Important environment variables seen by the kitty process:
PATH /Users/funa/.local/share/zinit/polaris/bin:/opt/local/bin:/opt/local/sbin:/opt/local/bin:/opt/local/sbin:/System/Cryptexes/App/usr/bin:/var/run/com.apple.security.cryptexd/codex.system/bootstrap/usr/local/bin:/var/run/com.apple.security.cryptexd/codex.system/bootstrap/usr/bin:/var/run/com.apple.security.cryptexd/codex.system/bootstrap/usr/appleinternal/bin:/pkg/env/global/bin:/Library/Apple/usr/bin:/Users/funa/bin/shell:/Users/funa/bin:/Users/funa/.local/nvim/bin:/Users/funa/.local/uv/bin:/Users/funa/.cargo/bin:/Users/funa/.nimble/bin:/Users/funa/.local/bin:/Users/funa/go/bin:/usr/local/cuda/bin:/usr/local/w3m/bin:/usr/local/sbin:/usr/X11R6/bin:/usr/local/anaconda3/bin:/Users/funa/.local/lib/npm/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:/opt/local/Library/Frameworks/Python.framework/Versions/3.8/bin:/opt/local/libexec/gnubin:/Applications/Ghostty.app/Contents/MacOS
LANG ja_JP.UTF-8
EDITOR nvim
SHELL /bin/zsh
DISPLAY :0
USER funa
XDG_DATA_DIRS /usr/local/share:/usr/share:/Applications/Ghostty.app/Contents/Resources/ghostty/..
LC_CTYPE ja_JP.UTF-8
LC_TIME C
LC_MESSAGES C
XDG_CONFIG_HOME /Users/funa/.config
Additional context
All reproduction steps above were run with kitten quick-access-terminal --config NONE, and I also emptied out ~/.config/kitty entirely and re-ran the steps, to rule out any config file interference. The bug is reproducible either way.
Describe the bug
When using
kitten quick-access-terminalwithedge=noneon macOS, increasingmargin_topbeyond a certain threshold causes the panel to keep moving down correctly, but its height also starts shrinking at the same time — as if the bottom edge of the panel is being clipped to a fixed position on screen, so increasingmargin_topeats into the panel's height instead of purely translating it.This makes it impossible to anchor a fixed-size panel to the bottom-left corner of the screen using
edge=none+margin_top, as documented, once the desiredmargin_topexceeds whatever this internal threshold is.To Reproduce
Steps to reproduce the behavior:
kitten quick-access-terminal --config NONE -o edge=none -o columns=1800px -o lines=1169px -o margin_left=0 -o margin_top=0The panel appears at the top-left, correctly sized at 1800x1169.
-o margin_top=300.The panel moves down, but its height is now visibly shorter than 1169.
-o margin_top=400.The panel moves further down, and the height shrinks even more.
Expected behavior
As long as
margin_top + linesfits within the screen height, the panel should stay at its configured size (lines/columns) and simply translate down bymargin_toppixels. Shrinking the panel would only make sense oncemargin_top + linesactually exceeds the screen height — which is not the case in this reproduction.Screenshots
Environment details
Additional context
All reproduction steps above were run with
kitten quick-access-terminal --config NONE, and I also emptied out~/.config/kittyentirely and re-ran the steps, to rule out any config file interference. The bug is reproducible either way.