Projects

• Projects
  • Creating a Project
    • Project Details
    • GitHub Repository
    • Linear Integration (Optional)
    • Sentry Integration (Optional)
  • Project Settings
    • Auto PR Reviews
    • Enable Mentions
  • Agent Personalization
    • Language
    • Tone
    • Persona
    • Custom Instructions
  • Webhook Configuration
  • How Projects Connect to Other Features
    • Code Generation
    • Code Reviews
    • Activity & Tasks
    • Automations
  • Managing Projects
    • Editing
    • Deleting
  • Tips

Projects connect your GitHub repositories to Themis, enabling automated code reviews, code generation, and cross-channel activity tracking. Each project links a GitHub repo with optional Linear and Sentry integrations.

Creating a Project

1. Go to Projects in the sidebar
2. Click New
3. Fill in the form:

Project Details

• Name — Display name in Themis (defaults to repo name)
• Description — Brief description of the project

GitHub Repository

Select a repository from the dropdown (populated from your connected GitHub account). This sets the owner and repo name, which cannot be changed after creation.

• Default branch — The primary branch to track (usually main)

Linear Integration (Optional)

Link a Linear team and project so Themis can create issues, track tasks, and cross-reference between GitHub PRs and Linear tickets.

1. Select a Team from the dropdown
2. Select a Project within that team

Sentry Integration (Optional)

Link a Sentry project so Themis can track error events and cross-reference alerts with code changes.

1. Select an Organization
2. Select a Project within that org

Project Settings

Auto PR Reviews

When enabled, Themis automatically reviews every pull request when it’s opened, updated, or marked ready for review. No manual trigger needed — reviews appear on the PR within minutes.

Enable Mentions

When enabled, Themis responds to @themis mentions in GitHub PR comments and issue comments. You can ask it to explain code, suggest fixes, or generate implementations directly from GitHub.

Agent Personalization

Each project can customize how the agent communicates. These settings apply to all code reviews, code generation, and mention responses for this project.

Language

Choose the agent’s response language:

• English, Chinese, Japanese, Korean, Spanish, French, German

Tone

Set the communication style:

Tone	Behavior
Professional	Formal and business-appropriate
Friendly	Approachable while remaining helpful
Strict	Thorough, doesn’t overlook issues
Casual	Conversational and relaxed

Persona

A custom personality description for the agent (e.g., “You are a senior Rails developer who values simplicity and test coverage”).

Custom Instructions

Additional guidance appended to the agent’s system prompt. Use this for project-specific rules like:

• “Always use Minitest, never RSpec”
• “Follow the repository’s CLAUDE.md conventions”
• “Reference Linear ticket IDs in commit messages”

Webhook Configuration

Each project displays webhook URLs for your connected services. Copy these into your GitHub, Linear, and Sentry project settings to enable real-time event processing.

Service	Events Handled
GitHub	PR opened/updated, review requested, comments, CI status
Linear	Issue assigned, status changed, comments
Sentry	New issues, alerts, metric events

How Projects Connect to Other Features

Code Generation

When you trigger code generation (from chat, Telegram, or a Linear assignment), Themis uses the project’s GitHub repo, default branch, and agent personalization. The generated PR targets the project’s repository.

Code Reviews

Reviews are posted to the project’s GitHub repo. Auto-review uses the project’s settings to decide when to trigger. The agent personalization (language, tone, custom instructions) shapes the review output.

Activity & Tasks

Webhook events from GitHub, Linear, and Sentry are linked to the project, enabling cross-channel task unification. A GitHub PR and its corresponding Linear issue appear as a single unified task in your inbox.

Automations

Event-triggered automations can filter by project. For example, you can create an automation that only runs when PRs are opened in a specific repository.

Managing Projects

Editing

Click a project from the list, then Edit. You can change all settings except the GitHub owner and repository name.

Deleting

Deleting a project removes all associated reviews and code generations. Activities and agent runs are preserved but unlinked from the project.

Deletion is permanent. All review history and code generation records for this project will be lost.

Tips

Enable auto-review on all active projects. It’s the highest-value setting — every PR gets instant feedback without anyone asking for it.

Use custom instructions to encode team conventions the agent should follow. This is more effective than hoping the agent infers your patterns from code alone.

Link all three services (GitHub + Linear + Sentry) for full cross-channel visibility. When a Sentry alert fires, Themis can trace it back to the PR that introduced the regression.