TeeckIn/Docs

AI Agents

Let AI coding assistants track time automatically as they work.

Overview

TeeckIn allows AI assistants to track time automatically as they work. Whether it's Claude Code, Cursor, or any MCP-compatible agent doing coding, research, writing, or analysis — agents are treated as first-class team members with their own identity and time entries.

Pro Feature

AI agents require a Pro or Team subscription. Free plans cannot create agents. See the for details.

Why Track AI Time?

Visibility

See how much work AI does vs humans. Understand your team's AI contribution.

Billing Control

Choose whether to include AI hours on client invoices. Bill at different rates if needed.

Audit Trail

Know exactly what work was AI-assisted. Important for compliance and transparency.

Automatic Tracking

AI tracks its own time. No manual entry needed - it just works as your AI handles tasks.

Authentication Methods

TeeckIn supports two authentication methods for AI agents:

●Browser-Based OAuth (Recommended)

Authentication happens in your browser - no secrets to manage or store in project files. The AI tool opens your browser, you log in to TeeckIn, select an agent, and you're connected.

Used by: Claude Code (MCP with PKCE)

●Client Credentials (API Keys)

For tools that don't support browser-based auth. You create an agent in TeeckIn, copy the Client ID and Client Secret, and configure them in your tool.

Used by: Codex CLI, Cursor, Copilot, Windsurf, custom integrations

Which method do I need?

If you're using Claude Code, use browser-based OAuth - it's simpler and more secure. For other tools, check their documentation to see if they support OAuth with PKCE. If not, use Client Credentials.

Supported Agents

Claude Code
Browser OAuth (no secrets)
OpenAI Codex
Client Credentials
Cursor
Client Credentials
GitHub Copilot
Client Credentials
Windsurf
Client Credentials
Custom
Client Credentials

Personal vs Organization Agents

Personal Agents

For solo developers and freelancers. Created in Settings > Agents.

  • - Track time on your personal topics
  • - No organization required
  • - Requires Pro subscription

Organization Agents

For teams. Created in Organization Settings > Agents.

  • - Track time on organization topics
  • - Each team member manages their own agents
  • - Requires Team plan on the organization

How It Works

Claude Code (Browser OAuth)

  1. 1Run npx @teeckin/agent init --claude in your project
  2. 2When Claude Code connects, your browser opens automatically
  3. 3Log in to TeeckIn and select (or create) an agent
  4. 4Done! Claude tracks time automatically - no secrets to manage

Other Tools (Client Credentials)

  1. 1Create an agent in TeeckIn (Settings > Agents)
  2. 2Copy the Client ID and Client Secret (shown once at creation)
  3. 3Run npx @teeckin/agent init and enter credentials when prompted
  4. 4The agent authenticates using your credentials

Agent Limits

PlanAgents per Member
FreeNot available
Pro5
Team5 per seat

In This Section

Learn how to set up and use AI agents:

Related

Claude Code Setup

Configure Claude Code with MCP

Codex Setup

Configure OpenAI Codex with MCP

API Usage

Direct API integration for any agent

Managing Agents

Create, configure, and monitor agents

Troubleshooting

Common issues and solutions