Ask Archil

What it does

Ask Archil is an interactive personal homepage where visitors chat with a Claude-powered AI assistant. The agent can answer questions about Archil's background, display his resume in a rich UI panel, and toggle the site between light and dark mode — all through natural conversation. Built with MCP client-side tools, the assistant uses three UI-rendering tools (theme toggle, theme check, resume display) that produce visual feedback directly in the chat interface rather than plain text responses.

Key features

• AI chat assistant — Claude Haiku 4.5 streams responses in real-time via SSE, with markdown rendering powered by Streamdown
• Client-side MCP tools — toggle-theme, check-theme, and show-resume tools render rich UI components inside the conversation
• Resume viewer — the agent can display Archil's resume as an interactive panel on demand
• Theme switching — ask the AI to switch between light and dark modes and see it happen live
• CAPTCHA-protected — Cloudflare Turnstile guards the streaming endpoint from bots
• JWT-authenticated streaming — short-lived tokens secure the Lambda-backed LLM endpoint
• Predefined prompts — three suggested conversation starters for first-time visitors
• Conversation persistence — chat history survives page refreshes via localStorage

Installation

This is a standalone web app, not an installable MCP server. Visit the live site or deploy your own instance.

To deploy your own:

git clone https://github.com/archil-l/ask-archil-io.git
cd ask-archil-io && npm install

Configure environment variables (see README), then:

npm run build && npm run release

Deploy to AWS via CDK:

npx cdk deploy --all

Supported hosts

Ask Archil is a web application with an embedded MCP client. Visit ask.archil.io directly — no MCP host configuration needed.