# KAIRO Documentation
> Intelligent deployment & orchestration

KAIRO is an AI control plane for deployment automation and infrastructure orchestration—chat over SSH or agent to deploy repos, auto-redeploy on git push, and troubleshoot with encrypted credentials.

## Documentation home
- [Operator guide](https://deploy.kunalchikte.in/docs): Complete KAIRO documentation hub

## Pages

### Getting Started
- [Introduction](https://deploy.kunalchikte.in/docs/getting-started/introduction): Overview of KAIRO — an AI control plane for deployment automation, server orchestration, and infrastructure operations via TESS chat.
- [What is KAIRO?](https://deploy.kunalchikte.in/docs/getting-started/what-is-kairo): KAIRO is your AI control plane for real servers—deployment automation, orchestration, encrypted credentials, and fleet visibility.
- [What is TESS?](https://deploy.kunalchikte.in/docs/getting-started/what-is-tess): TESS is KAIRO's AI assistant for server chat—streaming answers, live remote commands, deployment workflows, and contextual quick replies.
- [Quick Start](https://deploy.kunalchikte.in/docs/getting-started/quick-start): Step-by-step guide: create a KAIRO account, add your first server, open TESS chat, and run your first deployment.
- [Glossary](https://deploy.kunalchikte.in/docs/getting-started/glossary): Definitions of KAIRO terms: TESS, kairo-agent, deploy profile, token quota, mutation approval, transport, and more.

### Account & Access
- [Sign Up](https://deploy.kunalchikte.in/docs/account/sign-up): Create a new KAIRO account with email and password, accept policies, and access the dashboard.
- [Sign In](https://deploy.kunalchikte.in/docs/account/sign-in): Sign in to KAIRO with email/password, Google, or GitHub OAuth. Sessions use secure httpOnly cookies.
- [Forgot Password](https://deploy.kunalchikte.in/docs/account/forgot-password): Request a one-time password (OTP) by email to reset your KAIRO account password.
- [Reset Password](https://deploy.kunalchikte.in/docs/account/reset-password): Set a new password using email and OTP from the forgot-password flow.
- [Accept Team Invite](https://deploy.kunalchikte.in/docs/account/accept-invite): Join a KAIRO team via invitation link—set password, accept invite, and access shared servers.
- [OAuth Sign-In](https://deploy.kunalchikte.in/docs/account/oauth): Google and GitHub OAuth flows for KAIRO login and GitHub repository connection (separate purposes).

### Dashboard
- [Dashboard Overview](https://deploy.kunalchikte.in/docs/dashboard/overview): KAIRO dashboard home at /dashboard — token usage charts, deployment stats, server health, and subscription summary.
- [Dashboard Navigation](https://deploy.kunalchikte.in/docs/dashboard/navigation): Sidebar, mobile bottom nav, and route highlighting for KAIRO dashboard—Servers, TESS Chats, Logs, Settings, and more.
- [Token Analytics](https://deploy.kunalchikte.in/docs/dashboard/token-analytics): Understand KAIRO token usage charts on the dashboard—monthly filters, per-server breakdown, and billing cycle alignment.

### Servers
- [Fleet Overview](https://deploy.kunalchikte.in/docs/servers/fleet-overview): Manage your server fleet at /dashboard/servers—connection status, agent health, and quick actions.
- [Add SSH Server](https://deploy.kunalchikte.in/docs/servers/add-ssh-server): Add a server via SSH—host, port, username, password or private key (.pem, .ppk supported).
- [Add Agent Server](https://deploy.kunalchikte.in/docs/servers/add-agent-server): Pair kairo-agent via 6-character code—outbound HTTPS/WSS only, no inbound ports required.
- [Verify Readiness](https://deploy.kunalchikte.in/docs/servers/verify-readiness): Run connectivity and deploy-readiness checks on SSH or agent servers before production chat.
- [Edit & Delete Servers](https://deploy.kunalchikte.in/docs/servers/edit-delete): Update server metadata and credentials or remove a server from your KAIRO fleet.
- [Server Credentials](https://deploy.kunalchikte.in/docs/servers/credentials): Manage encrypted SSH credentials and GitHub deploy keys stored per server in KAIRO.

### TESS Chat
- [TESS Chats Hub](https://deploy.kunalchikte.in/docs/chat/chats-hub): Pick a server to open TESS chat at /chats—per-server token spend and fleet totals.
- [Per-Server Chat](https://deploy.kunalchikte.in/docs/chat/per-server-chat): Core TESS experience at /dashboard/servers/[id]/chat—isolated context, insights panel, and Socket.io streaming.
- [Model Selector](https://deploy.kunalchikte.in/docs/chat/model-selector): Choose enabled LLM models from GET /chat/models—plan assignments and provider routing apply.
- [Composer & Sending](https://deploy.kunalchikte.in/docs/chat/composer): Chat input behaviour—Enter to send, Shift+Enter for newline, disabled state during streaming.
- [Thinking & Streaming](https://deploy.kunalchikte.in/docs/chat/thinking-streaming): Inline reasoning during active turns—ChatThinkingBlock separates thinking from final answers.
- [Quick Replies](https://deploy.kunalchikte.in/docs/chat/quick-replies): Backend-driven suggestion chips under assistant messages—click to auto-send contextual replies.
- [Mutation Approval](https://deploy.kunalchikte.in/docs/chat/mutation-approval): Approve Yes or Read-only before TESS runs install/write commands—persist alwaysApprove per server.
- [Live Terminal](https://deploy.kunalchikte.in/docs/chat/live-terminal): Stream remote command stdout/stderr in-chat via commandLive chunks and ChatLiveTerminal.
- [Server Insights — Health](https://deploy.kunalchikte.in/docs/chat/insights-health): Health tab: connectivity, GitHub, deploy-ready checks, live CPU/RAM/disk polling ~10s.
- [Server Insights — Git Repos](https://deploy.kunalchikte.in/docs/chat/insights-git-repos): Git repos tab: integrations, auto-deploy toggles, deploy profile editor, manual redeploy.
- [Deploy via Chat](https://deploy.kunalchikte.in/docs/chat/deploy-via-chat): End-to-end deployment through TESS—clone, analyse, runtime pick, install approval, verify live.

### GitHub Integration
- [Connect GitHub](https://deploy.kunalchikte.in/docs/github/connect): Link GitHub account via OAuth popup in Settings for repo access and deployments.
- [Deploy Keys](https://deploy.kunalchikte.in/docs/github/deploy-keys): SSH deploy keys for git clone on servers—auto-generated or GitHub App github.deploy_key.install on agents.
- [Auto-Deploy](https://deploy.kunalchikte.in/docs/github/auto-deploy): Git push triggers deploy via GitHub App webhook or legacy per-repo hooks.
- [Deploy Profile](https://deploy.kunalchikte.in/docs/github/deploy-profile): Configure deployPath, pullCommands, preDeployCommands, restartCommands, pm2AppName for git_integrations.

### Deployments & Logs
- [Deployment Logs](https://deploy.kunalchikte.in/docs/deployments/logs): View deployment history at /logs—grouped by server and repo with status and commit links.
- [Filter & Search](https://deploy.kunalchikte.in/docs/deployments/filter-search): Filter deployment logs by status, source (chat vs webhook), and search by repo or message.

### Objectives
- [Objectives List](https://deploy.kunalchikte.in/docs/objectives/list): Create and manage objectives at /objectives—requires ENABLE_OBJECTIVES on API.
- [Objective Detail](https://deploy.kunalchikte.in/docs/objectives/detail): Execution timeline, verification results, and controls at /objectives/[id].
- [Self-Healing](https://deploy.kunalchikte.in/docs/objectives/self-healing): Repair sessions and knowledge articles when ENABLE_SELF_HEALING is on.

### Billing & Usage
- [Token Usage](https://deploy.kunalchikte.in/docs/billing/token-usage): Monitor KAIRO token consumption at /usage—quota, bonus tokens, and billing cycle reset.
- [Plans & Subscription](https://deploy.kunalchikte.in/docs/billing/plans-subscription): Subscribe to Starter, Pro, or Teams—INR pricing via Stripe or Cashfree (BILLING_PROVIDER).
- [Top-Up Tokens](https://deploy.kunalchikte.in/docs/billing/top-up): Purchase bonus tokens when on active plan—₹100–₹10,000 at 10 tokens per rupee.
- [Checkout Flow](https://deploy.kunalchikte.in/docs/billing/checkout): Stripe/Cashfree checkout return pages at /billing/success and /billing/cancel.

### Settings
- [Account Settings](https://deploy.kunalchikte.in/docs/settings/account): Profile, avatar, phone, password at /settings?tab=account.
- [Team Settings](https://deploy.kunalchikte.in/docs/settings/team): Invite members, revoke invites, remove members—owner/admin at /settings?tab=team.
- [Billing Settings](https://deploy.kunalchikte.in/docs/settings/billing): Manage subscription, portal, cancel, top-up at /settings?tab=billing.
- [GitHub Settings](https://deploy.kunalchikte.in/docs/settings/github): Connect GitHub and browse accessible repos at /settings?tab=github.
- [Notifications](https://deploy.kunalchikte.in/docs/settings/notifications): Notification preferences at /settings?tab=notifications.
- [Appearance](https://deploy.kunalchikte.in/docs/settings/appearance): Theme and display preferences at /settings?tab=appearance.

### kairo-agent
- [kairo-agent Overview](https://deploy.kunalchikte.in/docs/agent/overview): Outbound-only Go agent for hosts—pairing, systemd, NoNewPrivileges execution model.
- [Pairing Flow](https://deploy.kunalchikte.in/docs/agent/pairing): 6-character code pairing—POST /agent/pairing/start and dashboard entry.
- [Install Instructions](https://deploy.kunalchikte.in/docs/agent/install): Per-arch amd64/arm64 install commands with sudo for initial host setup.
- [Register Page](https://deploy.kunalchikte.in/docs/agent/register): Approve pairing at /register—link agent to server with preview of host/OS/arch.

### Marketing & Legal
- [Landing Page](https://deploy.kunalchikte.in/docs/marketing/landing): Public marketing homepage at /—hero, capabilities, pricing, FAQ, early access.
- [Early Access Signup](https://deploy.kunalchikte.in/docs/marketing/early-access): Request early access at #early-access—POST /waitlist/join with UTM attribution.
- [Legal Policies](https://deploy.kunalchikte.in/docs/marketing/legal): Privacy, Terms, Refund, Cancellation, Autonomous Operations at /legal.

## Sitemap
- https://deploy.kunalchikte.in/sitemap.xml

## Contact
- Website: https://deploy.kunalchikte.in