gistfile1.txt

# Obsidian Terminal Plugin Troubleshooting Guide

If you are running Claude Code on Windows using Git Bash (MINGW64) inside Obsidian and running into issues, here are the two most common problems and how to quickly resolve them.

---

## Issue 1: The Terminal UI Looks Broken or Garbled

**The Problem:** 
When you open Claude Code, the text is misaligned, lines wrap in weird ways, and the interface looks completely scrambled. This happens because Git Bash doesn't automatically tell the terminal how wide or tall it is, so Claude Code gets confused about where to place the text.

**The Fix:** 
You need to add two lines of code to a hidden configuration file called `~/.bashrc` to manually set the dimensions of your terminal, and then restart it.

**The Prompt (Copy & paste this to your AI agent):**
> "My terminal UI is garbled. Can you check if my COLUMNS and LINES environment variables are empty? If they are, please add the following two lines to my `~/.bashrc` file:
> `export COLUMNS=$(tput cols 2>/dev/null || echo 220)`
> `export LINES=$(tput lines 2>/dev/null || echo 50)`
> Once you have added them, confirm it's done and remind me to restart my terminal."

---

## Issue 2: Terminal Plugin "Error 9009"

**The Problem:** 
You try to run the terminal plugin and immediately get hit with an "error 9009". This usually means you are missing some required Python background files (dependencies) and your Obsidian plugin is pointing to an unsupported or incorrect version of Python (like 3.14). 

**The Fix:** 
You need to install three missing Python packages via your terminal, and then manually update the Python version inside your Obsidian settings. 

**The Prompt (Copy & paste this to your AI agent):**
> "I am getting an error 9009 in my Obsidian terminal. Please run the following command to install the missing Python dependencies: `pip install psutil pywinctl typing_extensions`. 
> 
> After the installation is successful, please remind me to do the following manual steps:
> 1. Open Obsidian -> Settings -> terminal plugin
> 2. Change the Python version from 3.14 to 3.12
> 3. Restart Obsidian
> 
> Please confirm when the installation is complete and you are ready for me to do the manual steps."