tc-doctor

tc-doctor

Self-diagnostic skill that checks the tinycode environment is correctly configured and fixes problems it finds. No dependencies beyond basic shell tools (curl, grep, awk, sed).

When to use

• The user says "doctor", "tc-doctor", "health check", "fix my setup"
• After a fresh install, deployment, or container restart
• When agents, skills, or tools aren't appearing
• When the model connection is failing or responses are slow
• When tool calling isn't working (model responds with text only)
• When asking why a tinycode feature isn't working (not their own application code)

When NOT to use

• The user is asking about their own application code (not tinycode itself)
• The user wants to configure a new provider (use /mcp-setup or /customize-tinycode instead)
• Debugging a specific session failure or code bug (use /debug or /trace)
• Choosing which model to use or comparing model capabilities (advise directly)
• Troubleshooting MCP server connections (use /mcp-setup)

Preamble: Detect Platform

Before running any checks, detect the platform. Gate container-specific checks behind IS_CONTAINER.

# Platform detection
IS_CONTAINER=false
if [ -f /run/.containerenv ] || [ -f /.dockerenv ]; then
  IS_CONTAINER=true
fi

IS_MAC=false
if [ "$(uname)" = "Darwin" ]; then
  IS_MAC=true
fi

OLLAMA_HOST="${TINYCODE_OLLAMA_HOST:-http://localhost:11434}"
TINYCODE_API="http://localhost:4096"

echo "## tinycode Doctor Report"
echo ""
echo "### Environment"
echo "- Platform: $(uname -s) $(uname -m)"
echo "- Container: $IS_CONTAINER"
echo "- Working directory: $(pwd)"
echo "- User: $(id -un) ($(id -u))"
echo "- Ollama endpoint: $OLLAMA_HOST"
if [ -n "$TINYCODE_OLLAMA_HOST" ]; then
  echo "  Source: TINYCODE_OLLAMA_HOST env var"
else
  echo "  Source: default"
fi
echo ""
echo "### Checks"

Checks to run (in order)

1. Directory structure

Verify these directories exist and are writable. Create any that are missing:

mkdir -p .tinycode 2>/dev/null && echo "✓ .tinycode/" || echo "✗ .tinycode/ — not writable"

for dir in .tinycode/plans .tinycode/state; do
  mkdir -p "$dir" 2>/dev/null && echo "✓ $dir" || echo "✗ $dir — not writable"
done

ls ~/.config/tinycode/ >/dev/null 2>&1 && echo "✓ ~/.config/tinycode/" || echo "✗ ~/.config/tinycode/ — missing"
ls ~/.local/share/tinycode/ >/dev/null 2>&1 && echo "✓ ~/.local/share/tinycode/" || echo "✗ ~/.local/share/tinycode/ — missing"