# Understand project structure
> "Analyze this codebase and explain its architecture"

# Find specific implementations
> "Where is the user authentication logic implemented?"

# Locate configuration files
> "Find all configuration files in this project"

# Refactoring
> "Rename all instances of 'getUserData' to 'fetchUserProfile'"

# Bug fixing
> "Find and fix the syntax error in main.py"

# Code quality
> "Add type hints to all functions in the utils module"

# Run tests
> "Execute the test suite and show results"

# Check code quality
> "Run linting and type checking"

# Build processes
> "Build the project and handle any errors"

# Bulk operations
> "Create a .gitignore file for a Python project"

# Content generation
> "Generate a basic setup.py file for this package"

# Documentation
> "Create API documentation for all public functions"

# Verify API key is set
echo $GEMINI_API_KEY  # Unix/Linux/macOS
echo %GEMINI_API_KEY% # Windows

# Test API connectivity
python -c "import os; print('Key found' if os.getenv('GEMINI_API_KEY') else 'Key missing')"

# Check .env file exists and has correct format
cat .env | grep GEMINI_API_KEY

# Test your API key validity
curl -H "Authorization: Bearer $DEEPSEEK_API_KEY" \
     -H "Content-Type: application/json" \
     https://api.deepseek.com/v1/models

# If council.py fails, check OpenAI/Gemini keys
python -c "import os; print('OpenAI:', bool(os.getenv('OPENAI_API_KEY'))); print('Gemini:', bool(os.getenv('GEMINI_API_KEY')))"

# Recreate virtual environment
rm -rf venv  # Remove existing venv
python -m venv venv

# Activate properly
source venv/bin/activate  # Unix/Linux/macOS
# OR
venv\Scripts\activate     # Windows

# Verify you're in the virtual environment
which python  # Should show path to venv/bin/python

# Update pip first
pip install --upgrade pip

# Clear pip cache
pip cache purge

# Install with verbose output for debugging
pip install -v -e .

# Alternative: Use uv for faster installs
pip install uv && uv pip install -e .

# Check tool imports
python -c "from smold.agent import get_available_tools; print(len(get_available_tools()))"

# Verbose tool loading
python main.py "test" --verbose

# Check specific tool
python -c "from smold.tools.bash_tool import bash_tool; print('Bash tool OK')"

# Check conversation context
python main.py -i
> context  # Shows current token usage

# Clear conversation history
> clear    # Resets context

# Reduce context if needed (edit system_prompt.py)
# Consider using shorter directory structures

# Test bash/powershell directly
bash -c "echo 'Bash test'"        # Unix/Linux/macOS
powershell -c "echo 'PS test'"    # Windows

# Check PATH and permissions
echo $PATH  # Unix/Linux/macOS
echo $env:PATH  # Windows PowerShell

# Verify working directory
pwd && ls -la

# Fix script permissions
chmod +x main.py run_tool_tests.sh

# Check file ownership
ls -la main.py smold/

# Run with elevated privileges (if needed)
sudo python main.py "system command"  # Unix/Linux/macOS
# Run PowerShell as Administrator  # Windows

# Check directory permissions
ls -ld $(pwd)

# Verify you can write to current directory
touch test_write && rm test_write

# Use absolute paths if relative paths fail
python main.py --cwd /full/path/to/project "your query"

# Install Python via Homebrew (recommended)
brew install [email protected]

# Fix zsh/bash compatibility
echo $SHELL  # Check current shell
bash        # Switch to bash if needed

# Xcode command line tools (may be required)
xcode-select --install

# Ensure bash is available
which bash  # Should return /bin/bash

# Install Python development headers (if needed)
sudo apt-get install python3-dev  # Ubuntu/Debian
sudo yum install python3-devel    # CentOS/RHEL

# Maximum debugging information
python main.py --debug --verbose "your query"

# Check agent initialization
python -c "from smold.agent import create_agent; agent = create_agent(); print('Agent created successfully')"

# Build the image
docker build -t smold:latest .

# Run interactive session
docker run -it --rm \
  -e DEEPSEEK_API_KEY=your_key_here \
  -v $(pwd):/workspace \
  smold:latest

# Run single query
docker run --rm \
  -e DEEPSEEK_API_KEY=your_key_here \
  -v $(pwd):/workspace \
  smold:latest python main.py "What files are in this directory?"

# Start the service
docker-compose up -d

# Access interactive mode
docker-compose exec smold bash

# View logs
docker-compose logs -f smold

# Run council consultation
docker-compose exec smold python smold/council.py --prompt "Review my code"

# Stop and cleanup
docker-compose down -v

# .env file
DEEPSEEK_API_KEY=your_deepseek_api_key_here
OPENAI_API_KEY=your_openai_api_key_here
GEMINI_API_KEY=your_gemini_api_key_here

# Optional: Configure council consultation limits
COUNCIL_MAX_TOKENS=60000
COUNCIL_TIMEOUT=300

# Monitor resource usage
docker stats smold-assistant

# Check health status
docker inspect --format='{{.State.Health.Status}}' smold-assistant

# Access conversation logs
docker exec smold-assistant ls -la council-logs/