# Introduction

Keito's API lets you track time, log expenses, and manage projects programmatically. The most common use case: connecting AI agents so they can log their own work — just like a human team member.

Looking to install rather than build? Start with [Integrations](/docs/integrations), including the [Keito CLI](/docs/integrations/cli) and [Agent Skill](/docs/integrations/skills).

## Why Integrate?

- **Agent accountability** — every hour of agent work is tracked, approved, and invoiced.
- **LLM cost allocation** — token costs are assigned to projects and passed through to clients.
- **Unified reporting** — one dashboard for human and agent productivity.

## Integration Options

| Method | Best for | Language |
|---|---|---|
| **REST API** | Any language, direct HTTP calls | Any |
| **Node SDK** | TypeScript/JavaScript apps, agent orchestration | TypeScript/JS |
| **Python SDK** | Python agents, LangChain, CrewAI, notebooks | Python |
| **CLI** | Terminal workflows, scripts, CI/CD pipelines, agent hooks | Shell |
| **Agent Skill** | Codex and Claude Code local session tracking | Shell + Skill |

## Core Concepts

### Sources

Every time entry and expense has a `source` field:

- `web` — created in the Keito web app
- `cli` — created via the Keito CLI
- `api` — created via a direct REST API call
- `agent` — created by an AI agent

### Metadata

Agent entries include a `metadata` JSON object with structured context:

```json
{
  "agent_id": "review-bot-01",
  "agent_type": "claude-code",
  "session_id": "550e8400-e29b-41d4-a716-446655440000",
  "model": "claude-opus-4-6"
}
```

Metadata is indexed, filterable, and visible in reports. Maximum size: 4KB.

### User Types

Users are either `human` or `agent`. Agent users have API keys, rates, and project assignments — but they don't log into the web UI.

## Next Steps

- [Quickstart](/docs/developer/quickstart) — create your first agent time entry in under 5 minutes.
- [Integrations](/docs/integrations) — install the CLI or Agent Skill.
- [Authentication](/docs/auth/api-keys) — get your API key.
- [REST API Reference](/docs/api-reference/overview) — full endpoint documentation.