Managing Agents

TeeckIn supports two types of agents, depending on your workflow:

Where you manage agents depends on the type:

• -Personal Agents: Settings > Agents (in personal context)
• -Organization Agents: Organization Settings > Agents

You can create agents either manually in TeeckIn, or automatically during the OAuth flow (for tools like Claude Code that support browser-based authentication).

Manual Creation (UI)

1. 1Click Add Agent
2. 2Select the agent type (Claude Code, Cursor, etc.)
3. 3Give it a descriptive name (e.g., "Jordan's MacBook Claude")
4. 4Optionally add a description
5. 5Click Create

Automatic Creation (Browser OAuth)

When using Claude Code or other tools that support browser-based OAuth, you can create a new agent directly in the authorization flow - no need to visit TeeckIn settings first.

The authorization screen shows all your available agents, grouped by context:

• -Personal: Your personal agents + option to create new
• -Organizations: Each org you belong to with its agents + option to create new

This allows you to choose where time should be tracked - under your personal account or under a specific organization - directly during the OAuth flow.

For tools that need Client Credentials authentication, each agent can have up to . Multiple secrets are useful for:

• -Zero-downtime secret rotation
• -Different machines (work laptop, home desktop)
• -CI/CD environments with separate secrets

Creating Additional Secrets

1. Click on the agent card to expand it
2. Go to the Secrets tab
3. Click New Secret
4. Optionally add a label (e.g., "Production Server")
5. Copy the new secret immediately - it won't be shown again

Deleting Secrets

To delete a secret, find it in the Secrets tab and click Delete. The secret stops working immediately. You must have at least one secret remaining.

Click the edit button on an agent card to change its name or description. The agent type cannot be changed after creation.

When you delete an agent:

• -All secrets are immediately invalidated
• +Time entries are preserved with full attribution
• -Agent is marked as inactive and hidden from lists
• +Inactive agents don't count toward plan limits

Time entries will show the agent's name with an "(Inactive)" badge in historical views.

Each agent card shows:

• -Last active: When the agent last made an API call
• -Secret count: How many active secrets exist

Each secret shows when it was last used, helping you identify and clean up unused credentials.

Activity Log

Expand an agent card and click the Activity Log tab to see a detailed history of the agent's actions. This includes:

• -Timer start/stop events
• -Time entry updates
• -Authentication attempts
• -IP addresses (for security monitoring)

Owners and admins can configure organization-wide agent settings from the Agents settings page:

• -Topic Selection Guidance: Help agents understand how to select the right topic based on the work they're doing
• -Default Agent Hourly Rate: Set a default rate for agent hours when included on invoices
• -Include Agent Hours on Invoices: Control whether agent hours are included by default when creating invoices

By default, agent hours are not included on invoices. When creating an invoice, you can choose to:

• -Exclude agent hours entirely (default)
• -Include at organization's default agent rate
• -Include at a custom rate for this invoice

Every time entry created by an agent is automatically tagged with the agent's identity. This attribution helps you:

• -Track AI-assisted work: Know exactly which entries were created by agents vs. humans
• -Audit compliance: Maintain clear records of AI involvement in your work
• -Billing decisions: Easily identify agent hours when preparing invoices

The agent's name appears on time entries in the calendar, timer history, and billing screens. Even if an agent is later deleted, the attribution is preserved showing "Deleted Agent" for historical records.

When you export your data, agents are included for historical accuracy:

• -Agent metadata: Name, type, and configuration are exported
• -Time entry attribution: Which agent created each entry is preserved
• -Secrets: Not exported (security)

When Importing

Agents are imported as inactive since secrets cannot be transferred. This ensures:

• +Historical attribution is preserved accurately
• +Audit trails remain intact
• -Imported agents cannot authenticate until reactivated

The calendar view includes filtering options to separate human and agent work:

• -All: Show all time entries from both humans and agents
• -Humans: Show only human team member entries
• -Agents: Show only AI agent entries

Access these filters by clicking the filter icon in the calendar toolbar. You can also combine these with member and group filters.