ai-context-cli

ai-context-cli

HTTP(S) → clean Markdown for LLM context: httpx fetch → Readability → markdownify; optional LiteLLM summary with --summary (lazy-loaded — no LLM stack until you opt in).

# Markdown only (stdout stays pipe-clean; errors → stderr)
ai-context-cli "https://example.com/article"

# Same + LLM summary (loads .env from cwd for API keys)
ai-context-cli "https://example.com/article" --summary

# Verbose pipeline logs on stderr
ai-context-cli "https://example.com/article" --summary -v

Architecture and conventions: SPEC.md.

⚡ Why

Raw HTML wastes tokens. ai-context-cli is a small preprocessing step: one URL in, readable Markdown (and optionally a short summary) out.

🧩 What you get

• Readability-based main content extraction (readability-lxml)
• Markdown via markdownify
• Optional LLM summary via LiteLLM (--summary, --model)
• Typed errors → stable CLI exit codes (see SPEC.md §7)

Scope today: SOURCE is an http(s) URL or a local file or directory (UTF-8 text; see SPEC §5). --structure and --version are available.

Quick Start

# 1) Install
pip install ai-context-cli

# 2) Convert a page to Markdown
ai-context-cli "https://example.com/article"

# 3) Show installed version
ai-context-cli --version

# 4) Add a summary block
ai-context-cli "https://example.com/article" --summary

📦 Install

From a clone (dev):

python3 -m venv .venv
source .venv/bin/activate   # Windows: .\.venv\Scripts\Activate.ps1
pip install -U pip
pip install -e ".[dev]"
ai-context-cli --help

From PyPI: pip install ai-context-cli

Requires Python 3.11+.

🤖 LLM providers (LiteLLM)

--summary uses LiteLLM model ids. Set the provider’s native env vars (also read from a .env in the working directory when --summary is used).

ai-context-cli "https://example.com/article" --summary --model "openrouter/openai/gpt-4o-mini"
ai-context-cli "https://example.com/article" --summary --model "ollama/llama3"

See .env.example for other keys (MISTRAL_API_KEY, timeouts, etc.).

🧪 Tests & lint

pytest
ruff check .
ruff format --check .
mypy src

🤝 Contributing

See CONTRIBUTING.md (layers, ports/adapters, where to put code).

📝 Changelog

Release notes are tracked in CHANGELOG.md.

📄 License

MIT — see LICENSE.