# Augment Code > Use Augment Code Review to automatically review PRs faster while catching more critical bugs. --- # Source: https://docs.augmentcode.com/codereview/admin-guide.md # Augment Code Review > Use Augment Code Review to automatically review PRs faster while catching more critical bugs. export const GitHubLogo = () => ; ## About Augment Code Review Augment Code Review helps professional software teams complete code-reviews faster inside GitHub while also catching more critical bugs before they hit production. Backed by Augment's industry-leading Context Engine, the agent understands your codebase at a deep level, providing reviews that are more meaningful and account for codebase-wide effects. Augment prioritizes high signal-to-noise ratio by focusing on high-impact issues like bugs, security concerns, correctness, and cross-system problems while avoiding low-value style nags. Augment Code Review relies on the Augment GitHub App which is only compatible with GitHub Enterprise Cloud and github.com. GitHub Enterprise Server is not currently supported. ## Getting Started Visit [app.augmentcode.com/settings/code-review](https://app.augmentcode.com/settings/code-review) and log in. Augment Code Review is only available as an add-on to [Enterprise plan](https://augmentcode.com/pricing) customers. Settings are accessible to all members of the Enterprise plan, but only configurable for Administrators of the Enterprise plan. If you aren't sure if you are an Administrator, please contact your solutions team. ### Configure Repo Access inside of the Augment GitHub App Before you can configure repositories, click on "Install" to install the Augment GitHub App. This will redirect you to GitHub to provide permissions for all the repos you grant Augment Code Review to engage. Code Review Settings install button If your firewall configuration, allowlist or network policy requires a static IP for this integration, please refer to our [static IP address](https://docs.augmentcode.com/setup-augment/static-ip-support#allow-augment-traffic-from-static-ips) documentation. To install the Augment GitHub App, you will need to be an Administrator of your GitHub organization. To find who the Administrators are, visit your GitHub organization settings page and click on "People." Administrators are listed under "Owners." GitHub Admins Once you finish installing the GitHub app, you should see a green checkmark with the text "All set!". Then, back in the Augment Code Review Settings, the "Install" button should now show a green "Installed" badge. If you do not see either of these, you may need to uninstall the app through GitHub and reinstall it. See [Troubleshooting](/codereview/admin-guide#stuck-on-install-button) for more help. GitHub App Installed ### Permissions requested by the Augment GitHub App: * Contents, read-only: Clone repositories * Pull Requests, read and write: Read pull requests and post comments to pull requests * Issues, read-only: Read top-level PRs / Issues * Organization Members, read-only: Read members of an organization, to distinguish internal and external users and their access levels to Augment features Organization owners and repository admins can install the app directly; others will need owner approval. See [GitHub documentation](https://docs.github.com/en/apps/using-github-apps/installing-a-github-app-from-a-third-party) for details. If your organization uses [Augment for Slack,](https://docs.augmentcode.com/setup-augment/install-slack-app) the same selections will apply to both Augment for Slack and Augment Code Review. Installing the GitHub app on a single repository You can modify repository access anytime in the Augment GitHub App settings. ### Configuring Triggers Per Repository As the Administrator, you control when Augment Code Review triggers via [Settings](https://app.augmentcode.com/settings/code-review): * **Automatic**: Augment Code Review will automatically review and post a comment as soon as the PR is opened for review in GitHub. Use it when your teams want immediate feedback on all pull requests. * **Manual Command**: Augment Code Review is only triggered when someone comments on the PR with any of the following: `auggie review`, `augment review`, or `augmentcode review` on GitHub. Use it when you want full control over when a review happens. * **Disabled**: Augment Code Review will not run on the repository. Trigger Types If the repo is set to "Automatic" or "Manual Command", to run additional rounds of reviews on a subsequent commit of any PR, you can use the same manual trigger keywords (`auggie review`, `augment review`, or `augmentcode review`). On public repositories, reviews are only triggered for PRs whose authors are members of the GitHub organization, outside collaborators to the organization or repository, or contributors to that repository. ## Change the GitHub Organization using Augment Code Review Today, Code Review is limited to one GitHub organization per Enterprise account. Augment will address this limitation in an upcoming release. You can change the organization by reinstalling the Augment GitHub App. * To get started you need to review the GitHub Apps installed on an organization: * In the top right corner of GitHub, click your profile picture, then click Your organizations. * Next to your organization name, click Settings. * In the side bar, under "Third-party Access," click GitHub Apps. A list of the GitHub Apps installed on your organization will be displayed. * Next to the GitHub App you want to review or modify, click Configure. * To uninstall the Augment GitHub App, click Uninstall. * To reinstall, visit: [https://github.com/apps/augmentcode/installations/new](https://github.com/apps/augmentcode/installations/new). Select your organization. ## Providing feedback You can provide in product feedback directly in GitHub by reacting with a thumbs up or thumbs down emoji to the inline comment left by Augment Code Review. Code Review Feedback using GitHub Reactions ## Tell Augment Code Review to check specific areas with guidelines Domain knowledge that isn't always evident in the code. Tell Augment Code Review to check specific areas like security vulnerabilities or inside particular directories when relevant. Augment Code Review allows you to outline these special guidelines per repository. Describe any areas of focus using a yaml file entitled code\_review\_guidelines.yaml inside the .augment folder at the repository root: `/.augment/code_review_guidelines.yaml` Scope guidelines to the appropriate sub-directories and focus on objective issues that can cause bugs, expose vulnerabilities, etc. and less on stylistic or subjective things. ### Example Augment Code Review Guidelines ```yaml theme={null} # Guidelines exclusive to augmentcode/auggie areas: databases: description: "Data and Database related rules" globs: - "**" rules: - id: "no_pii_in_bigquery" description: "Never store PII data in BigQuery tables." severity: "high" - id: "no_guid_keys" description: "GUID foreign keys can slow lookups" severity: "medium" memory_safety: description: "Ensure Memory Safety" globs: - "kernel/**" rules: - id: "avoid_unsafe_rust" description: "Avoid unsafe Rust operations." severity: "high" ``` ### Explanation of the Guideline Format **Areas:** Focus domain. Example: focus is “databases” **Area Name**: Double quoted string written in snake case (ex: memory\_safety) * **Description:** Double quoted message summarizing intent of the area * **Globs** (short for global): Double quoted pattern-matching notation. Used to specify sets of filenames or paths using wildcard characters Common **globs** or pattern matching syntax: * `**` - Matches any number of directories (recursive wildcard) * Example: `**/test.py` matches `test.py`, `src/test.py`, `src/utils/test.py`, etc. * `*` - Matches any sequence of characters within a single directory level * Example: `*.py` matches `file.py`, `main.py` but not `src/main.py` * `?` - Matches exactly one character * Example: `test?.py` matches `test1.py`, `testA.py` but not `test10.py` * **Rules:** Areas can contain more than one rule. Each rule contains: * **ID**: Double quoted title written in snake case (ex: avoid\_unsafe\_rust) * **Description**: Double quoted message summarizing intent of the rule * **Severity**: Expects double quoted “high”, “medium” or “low”. Sets the priority of review by Augment Code Review ## User Access Administrators can specify a list of GitHub users who can trigger Augment Code Review by turning on **Allowlist Mode**. When Allowlist Mode is active, only users in the allowlist will be able to trigger Augment Code Review. Automatic and manual reviews will be disabled for all other users. This is useful for organizations that want to limit access to the feature to a select group of users. To manage permissions, visit [User Access for Code Review](https://app.augmentcode.com/settings/code-review/user-access). ## Model Context Protocol (MCP) Administrators can connect Augment Code Review to external context sources through Model Context Protocol (MCP). Augment Code Review supports both local and remote MCP servers. * Remote MCP servers run remotely and are hosted by providers. Once you add a remote MCP server, you may need to complete an OAuth flow to sign in to the server before it can be used by the code review agent. * Local MCP servers run in their own environment within the code review agent's workspace. You can specify environment variables for local servers by clicking + MCP and then clicking + Environment Variable. Once set, environment variables are write-only and can only be overwritten or removed (not viewed) after the server has been added. To configure MCP servers, visit [MCP for Code Review](https://app.augmentcode.com/settings/code-review/mcp). ## Code Review Analytics Use the Code Review Analytics dashboard to track the review load automated by Augment, along with the comments made by Code Review that developers ultimately addressed. 1. **Navigate to Code Review** - In your browser, visit [Code Review Analytics](https://app.augmentcode.com/code-review/analytics). 2. **Filter by Date** - Refine your Analytics using the tabs for Last 7 Days, Last 30 Days, or Last 60 Days. ### Metric Definitions * **Total PRs Reviewed**: The number of PRs that have been reviewed by Augment Code Review. * **Total Reviews Performed**: The number of reviews that have been run by Augment Code Review. One PR can have multiple reviews if people manually trigger more reviews. * **Total Comments**: The total number of inline comments left by Augment Code Review. * **Percentage of Comments Addressed**: A comment is addressed if the developer resolved the concerns raised by the Augment Code Review comment. The percentage is calculated by dividing the number of addressed comments by the total number of comments left by Augment Code Review. * **Percentage of Thumbs Up Reactions**: A thumbs up reaction is counted if a user reacts with the Thumbs Up emoji on GitHub on an inline comment left by Augment Code Review. The percentage is calculated by dividing the number of thumbs up reactions by the total number of thumbs up and thumbs down emoji reactions. * **Estimated Dev Hours Saved**: Number of PRs multiplied by 10 minutes ### Reading the Charts * **Addressed Comments**: A chart detailing total number of comments per day broken down by unaddressed (gray) vs addressed (green). You can interpret the green bar to mean Augment Code Review caught issues that developers fixed and may not have without the comment. * **Reviewed PRs**: A chart detailing the total number of reviewed PRs per day (blue). ## Troubleshooting ### Stuck on Install button If you still see the “Install” button on the Augment Code Review Settings page, then the Augment GitHub App installation failed. You will need to uninstall the Augment GitHub App from your organization and then reinstall it. Make sure the person installing the GitHub app has an Augment account and they see the "All set!" text after installing the app. Follow the steps on [GitHub Docs](https://docs.github.com/en/apps/using-github-apps/reviewing-and-modifying-installed-github-apps#navigating-to-the-github-app-you-want-to-review-or-modify) to modify the Augment GitHub App installation. In the Danger zone section, click on "Uninstall" Follow the steps in [Getting Started](/codereview/admin-guide#getting-started) again to install the app --- # Source: https://docs.augmentcode.com/setup-augment/agent-integrations.md # Source: https://docs.augmentcode.com/jetbrains/setup-augment/agent-integrations.md > ## Documentation Index > Fetch the complete documentation index at: https://docs.augmentcode.com/llms.txt > Use this file to discover all available pages before exploring further. # Agent Integrations > Configure integrations for Augment Agent to access external services like GitHub, Linear, Jira, Confluence, and Notion. export const Keyboard = ({shortcut}) => {shortcut} ; export const Command = ({text}) => {text}; export const GleanLogo = () => ; export const ConfluenceLogo = () => ; export const JiraLogo = () => ; export const NotionLogo = () => ; export const LinearLogo = () => ; export const GitHubLogo = () => ; ## About Agent Integrations Augment Agent can access external services through integrations to add additional context to your requests and take actions on your behalf. These integrations allow Augment Agent to seamlessly work with your development tools without leaving your editor. Once set up, Augment Agent will automatically use the appropriate integration based on your request context. Or, you can always mention the service in your request to use the integration. ## Setting Up Integrations To set up integrations with Augment Agent in JetBrains IDEs, follow these steps: 1. Click the Augment icon in the bottom right of your IDE and select 2. Click "Connect" for the integration you want to set up Set up integrations in the settings page You'll be redirected to authorize the integration with the appropriate service. After authorization, the integration will be available for use with Augment Agent. ## Easy MCP Integrations > **New:** Easy MCP launched ONLY July 30, 2025, providing one-click access to popular developer tools. Easy MCP transforms complex MCP server setup into a single click. Available integrations include: * **CircleCI** - Build logs, test insights, and flaky-test detection * **MongoDB** - Data exploration, database management, and context-aware code generation * **Redis** - Keyspace introspection, TTL audits, and migration helpers For detailed setup instructions and examples, see [Configure MCP servers](/jetbrains/setup-augment/mcp). ## Native Integrations ##
GitHub Integration
Add additional context to your requests and take actions. Pull in information from a GitHub Issue, make the changes to your code (or have Agent do it for you), and open a Pull Request all without leaving your editor. ### Examples * "Implement Issue #123 and open up a pull request" * "Find all issues assigned to me" * "Check the CI status of my latest commit" For authorization details, see [GitHub documentation](https://docs.github.com/en/apps/using-github-apps/installing-a-github-app-from-a-third-party). ##
Linear Integration
Read, update, comment on, and resolve your Linear issues within your IDE. ### Examples * "Fix TES-1" * "Create Linear tickets for these TODOs" * "Help me triage these new bug reports" For authorization details, see [Linear documentation](https://linear.app/docs/third-party-application-approvals). ##
Jira Integration
Work on your Jira issues, create new tickets, and update existing ones. ### Examples * "Show me all my assigned Jira tickets" * "Create a Jira ticket for this bug" * "Create a PR to fix SOF-123" * "Update the status of PROJ-123 to 'In Progress'" For authorization details, see [Jira documentation](https://support.atlassian.com/jira-software-cloud/docs/allow-oauth-access/). ##
Confluence Integration
Query existing documentation or update pages directly from your IDE. Ensure your team's knowledge base stays current without any context switching. ### Examples * "Summarize our Confluence page on microservice architecture" * "Find information about our release process in Confluence" * "Update our onboarding docs to explain how we use Bazel" For authorization details, see [Confluence documentation](https://developer.atlassian.com/cloud/confluence/oauth-2-3lo-apps/). ##
Notion Integration
Search and retrieve information from your team's knowledge base - access documentation, meeting notes, and project specifications. This integration is currently READ-ONLY. ### Examples * "Find Notion pages about our API documentation" * "Show me the technical specs for the payment system" * "What outstanding tasks are left from yesterday's team meeting?" For authorization details, see [Notion documentation](https://www.notion.so/help/add-and-manage-connections-with-the-api#install-from-a-developer). ##
Glean Integration
> **Note:** The Glean integration is in early access and thus is a little different from other integrations. > > * It is currently only available to enterprise customers. > * It does not appear in the list of integrations in the settings panel. The Glean integration lets the agent retrieve information from your team's internal data sources leveraging Glean's powerful search engine. **To Enable the Glean Integration:** You'll need to be have administrator access to Augment and Glean. Follow the instructions on [https://app.augmentcode.com/gleanConfig](https://app.augmentcode.com/gleanConfig) and your agent will be ready to use Glean! ### Examples * "Search Glean for past related incidents and how they were resolved" * "Search Glean for why we're migrating to a new payment processor" ## Next Steps * [Configure additional tools with Easy MCP or advanced MCP setup](/jetbrains/setup-augment/mcp) * Explore one-click integrations for CircleCI, MongoDB, and Redis through Easy MCP --- # Source: https://docs.augmentcode.com/using-augment/agent.md # Source: https://docs.augmentcode.com/jetbrains/using-augment/agent.md # Source: https://docs.augmentcode.com/cli/acp/agent.md > ## Documentation Index > Fetch the complete documentation index at: https://docs.augmentcode.com/llms.txt > Use this file to discover all available pages before exploring further. # ACP Mode > Auggie is a fully compatible Agent Client Protocol (ACP) agent enabling you to bring the power of Augment to any compatible client. ## About ACP Mode [Agent Client Protocol](https://agentclientprotocol.com/overview/introduction) (ACP) is an open protocol that provides a standardized way to connect AI agents to different text editors, IDEs, and other tools. ACP mode uses JSON-RPC over standard input and output to communicate between the agent and the client. You can see a [overview of the protocol](https://agentclientprotocol.com/protocol/overview) to learn more. ## Using ACP Mode To use Auggie in ACP mode, you need to pass the `--acp` flag when starting Auggie. You can pass additional [command-line arguments](/cli/reference) to set the model, authentication, and other options. ```sh theme={null} auggie --acp ``` To use Auggie in a ACP-compatible client, you need to configure the client to launch Auggie with the `--acp` flag and follow the client-specific instructions. See the [ACP Clients](/cli/acp/clients) page for more details. ## Compatibility ACP is an emerging protocol and is in active development. Not all features available in interactive mode are supported in ACP mode. We are looking forward to working with the community to add support for more features in the future. --- # Source: https://docs.augmentcode.com/analytics/analytics-api.md > ## Documentation Index > Fetch the complete documentation index at: https://docs.augmentcode.com/llms.txt > Use this file to discover all available pages before exploring further. # Analytics API > Access usage metrics and analytics for your organization. **Preview Feature** The Analytics API is currently in preview and is available exclusively to Enterprise customers. The Analytics API provides access to usage metrics for your organization, including how Augment Code is being used across your team. It allows you to build your own AI integration dashboards with tools like Jellyfish. Track daily active users, usage patterns, and detailed activity metrics to understand and optimize your team's use of Augment Code. ## Base URL | Environment | URL | | ----------- | ----------------------------- | | Production | `https://api.augmentcode.com` | ## Getting started To use the Analytics API, you need to create a service account and generate an API token. 1. Navigate to your organization's **Service Accounts** page in the Augment web app: [app.augmentcode.com/settings/service-accounts](https://app.augmentcode.com/settings/service-accounts) 2. Click **Add Service Account** 3. Enter a **Service Name** (1-100 characters, alphanumeric, hyphens, and underscores only) 4. Optionally add a **Description** for the service account 5. Click **Create** Service account names must be unique within your organization. 1. In the **Service Accounts** list, find your newly created service account 2. Click **Create Token** 3. Enter a **Token Description** (e.g., "Analytics API integration") 4. Click **Create** 5. **Copy and securely store the token** — it will only be shown once Treat API tokens like passwords. Do not share them or commit them to version control. Include the token in the `Authorization` header of your API requests: ```bash theme={null} curl -X GET "https://api.augmentcode.com/analytics/v0/dau-count" \ -H "Authorization: Bearer " ``` For more details on service accounts, see the [Service Accounts documentation](/cli/automation/service-accounts). ## Available Endpoints The Analytics API provides several endpoints to access different types of usage data: Get daily active user counts over a date range Get the list of active users for a specific date with pagination Get aggregated usage metrics by day over a date range Get per-user usage metrics over a date range with pagination Get user activity broken down by programming language and editor ## Important Considerations **Timezone and Data Availability** All dates in requests and responses are interpreted and returned in **UTC timezone**. The most recent queryable date is "yesterday" (UTC), and data for the previous day becomes available at approximately **02:00 UTC** each day. Make sure to account for this when querying data or processing results. **Data Freshness** Analytics data is updated once daily. Data for a given day becomes available the following day at approximately 02:00 UTC. ### Common Constraints Most endpoints share these constraints: | Constraint | Value | | --------------------------- | ---------------------------------------------------- | | Maximum date range | 90 days | | Maximum historical lookback | 2 years | | Today and future dates | Not allowed (data available at \~02:00 UTC next day) | | Timezone | All dates interpreted as UTC | ## Next Steps View detailed API endpoint documentation Learn more about service accounts and authentication --- # Source: https://docs.augmentcode.com/codereview/analytics-dashboard.md > ## Documentation Index > Fetch the complete documentation index at: https://docs.augmentcode.com/llms.txt > Use this file to discover all available pages before exploring further. # Analytics Dashboard > Track code review metrics and measure the impact of Augment Code Review on your team. ## Code Review Analytics Use the Code Review Analytics dashboard to track the review load automated by Augment, along with the comments made by Code Review that developers ultimately addressed. 1. **Navigate to Code Review** - In your browser, visit [Code Review Analytics](https://app.augmentcode.com/code-review/analytics). 2. **Filter by Date** - Refine your Analytics using the tabs for Last 7 Days, Last 30 Days, or Last 60 Days. ### Metric Definitions * **Total PRs Reviewed**: The number of PRs that have been reviewed by Augment Code Review. * **Total Reviews Performed**: The number of reviews that have been run by Augment Code Review. One PR can have multiple reviews if people manually trigger more reviews. * **Total Comments**: The total number of inline comments left by Augment Code Review. * **Percentage of Comments Addressed**: A comment is addressed if the developer resolved the concerns raised by the Augment Code Review comment. The percentage is calculated by dividing the number of addressed comments by the total number of comments left by Augment Code Review. * **Percentage of Thumbs Up Reactions**: A thumbs up reaction is counted if a user reacts with the Thumbs Up emoji on GitHub on an inline comment left by Augment Code Review. The percentage is calculated by dividing the number of thumbs up reactions by the total number of thumbs up and thumbs down emoji reactions. * **Estimated Dev Hours Saved**: Number of PRs multiplied by 10 minutes ### Reading the Charts * **Addressed Comments**: A chart detailing total number of comments per day broken down by unaddressed (gray) vs addressed (green). You can interpret the green bar to mean Augment Code Review caught issues that developers fixed and may not have without the comment. * **Reviewed PRs**: A chart detailing the total number of reviewed PRs per day (blue). --- # Source: https://docs.augmentcode.com/context-services/sdk/api-reference.md # Source: https://docs.augmentcode.com/analytics/api-reference.md > ## Documentation Index > Fetch the complete documentation index at: https://docs.augmentcode.com/llms.txt > Use this file to discover all available pages before exploring further. # Analytics API Reference > Detailed API endpoint documentation. **Preview Feature** The Analytics API is currently in preview and is available exclusively to Enterprise customers. **Important: Timezone and Data Availability** All dates in requests and responses are interpreted and returned in **UTC timezone**. The most recent queryable date is "yesterday" (UTC), and data for the previous day becomes available at approximately **02:00 UTC** each day. **Data Freshness** Analytics data is updated once daily. Data for a given day becomes available the following day at approximately 02:00 UTC. ## GET /analytics/v0/dau-count Returns daily active user counts over a date range. ### Query Parameters | Parameter | Type | Required | Description | | ----------- | ------ | -------- | --------------------------------------- | | start\_date | string | No | Start date in `YYYY-MM-DD` format (UTC) | | end\_date | string | No | End date in `YYYY-MM-DD` format (UTC) | ### Date Range Behavior | Scenario | Behavior | | -------------------------- | -------------------------------------------------------------- | | Neither date provided | Returns last 7 days ending at yesterday (UTC) | | Only `start_date` provided | Returns 7 days starting from `start_date`, capped at yesterday | | Only `end_date` provided | Returns 7 days ending at `end_date` | | Both dates provided | Returns the specified inclusive range | ### Constraints | Constraint | Value | | --------------------------- | ---------------------------------------------------- | | Maximum date range | 90 days | | Maximum historical lookback | 2 years | | Today and future dates | Not allowed (data available at \~02:00 UTC next day) | | Timezone | All dates interpreted as UTC | ### Example Request ```bash theme={null} curl -X GET "https://api.augmentcode.com/analytics/v0/dau-count?start_date=2025-10-15&end_date=2025-10-20" \ -H "Authorization: Bearer " ``` ### Example Response ```json theme={null} { "daily_active_user_counts": [ {"date": "2025-10-15", "user_count": 100}, {"date": "2025-10-16", "user_count": 120}, {"date": "2025-10-17", "user_count": 95}, {"date": "2025-10-18", "user_count": 140}, {"date": "2025-10-19", "user_count": 88}, {"date": "2025-10-20", "user_count": 110} ], "metadata": { "effective_start_date": "2025-10-15", "effective_end_date": "2025-10-20", "generated_at": "2025-10-21T10:30:00Z", "total_days": 6 } } ``` ### Response Fields | Field | Type | Description | | ------------------------------------------ | ------- | ----------------------------------------------------- | | daily\_active\_user\_counts | array | Array of daily user counts, one per day | | daily\_active\_user\_counts\[].date | string | Calendar date (`YYYY-MM-DD`) | | daily\_active\_user\_counts\[].user\_count | integer | Number of unique active users | | metadata.effective\_start\_date | string | Actual start date used (UTC, after defaults/clamping) | | metadata.effective\_end\_date | string | Actual end date used (UTC, after defaults/clamping) | | metadata.generated\_at | string | Response generation timestamp (ISO 8601) | | metadata.total\_days | integer | Number of days in the range | *** ## GET /analytics/v0/dau Returns the list of active users for a specific date. Supports pagination. ### Query Parameters | Parameter | Type | Required | Description | | ---------- | ------- | -------- | ------------------------------------------ | | date | string | No | Date to query in `YYYY-MM-DD` format (UTC) | | cursor | string | No | Pagination cursor from previous response | | page\_size | integer | No | Number of results per page | ### Date Behavior | Scenario | Behavior | | ----------------- | ---------------------------------------------------------------- | | Date not provided | Defaults to yesterday (UTC) | | Date provided | Returns users active on that date (must be yesterday or earlier) | ### Pagination | Parameter | Default | Maximum | | ---------- | ------- | ------- | | page\_size | 100 | 250 | To paginate through results: 1. Make initial request (optionally with `page_size`) 2. If `pagination.has_more` is `true`, use `pagination.next_cursor` as the `cursor` parameter 3. Repeat until `has_more` is `false` ### Constraints | Constraint | Value | | --------------------------- | ---------------------------------------------------- | | Maximum historical lookback | 2 years | | Today and future dates | Not allowed (data available at \~02:00 UTC next day) | | Timezone | All dates interpreted as UTC | ### Example Request (First Page) ```bash theme={null} curl -X GET "https://api.augmentcode.com/analytics/v0/dau?date=2025-10-15&page_size=50" \ -H "Authorization: Bearer " ``` ### Example Response ```json theme={null} { "users": [ {"user_email": "alice@example.com"}, {"user_email": "bob@example.com"}, {"service_account_name": "ci-bot"} ], "pagination": { "next_cursor": "eyJsYXN0X2lkIjoidXNlcjUwIn0=", "has_more": true }, "metadata": { "effective_date": "2025-10-15", "generated_at": "2025-10-16T10:30:00Z", "returned_user_count": 3 } } ``` ### Example Request (Next Page) ```bash theme={null} curl -X GET "https://api.augmentcode.com/analytics/v0/dau?date=2025-10-15&page_size=50&cursor=eyJsYXN0X2lkIjoidXNlcjUwIn0=" \ -H "Authorization: Bearer " ``` ### Response Fields | Field | Type | Description | | ------------------------------- | ------- | -------------------------------------------------------- | | users | array | Array of active users | | users\[].user\_email | string | User's email address (for regular users) | | users\[].service\_account\_name | string | Service account name (for service accounts) | | pagination.next\_cursor | string | Cursor for fetching next page (empty if no more results) | | pagination.has\_more | boolean | `true` if more results are available | | metadata.effective\_date | string | Actual date used (UTC, after defaults) | | metadata.generated\_at | string | Response generation timestamp (ISO 8601) | | metadata.returned\_user\_count | integer | Number of users returned in this page | Each user has either `user_email` or `service_account_name`, never both. *** ## GET /analytics/v0/daily-usage Returns daily usage metrics for your organization over a date range. Days with no activity are omitted from the response. ### Query Parameters | Parameter | Type | Required | Description | | ----------- | ------ | -------- | --------------------------------------- | | start\_date | string | No | Start date in `YYYY-MM-DD` format (UTC) | | end\_date | string | No | End date in `YYYY-MM-DD` format (UTC) | ### Date Range Behavior | Scenario | Behavior | | -------------------------- | -------------------------------------------------------------- | | Neither date provided | Returns last 7 days ending at yesterday (UTC) | | Only `start_date` provided | Returns 7 days starting from `start_date`, capped at yesterday | | Only `end_date` provided | Returns 7 days ending at `end_date` | | Both dates provided | Returns the specified inclusive range | ### Constraints | Constraint | Value | | --------------------------- | ---------------------------------------------------- | | Maximum date range | 90 days | | Maximum historical lookback | 2 years | | Today and future dates | Not allowed (data available at \~02:00 UTC next day) | | Timezone | All dates interpreted as UTC | ### Example Request ```bash theme={null} curl -s -X GET "https://api.augmentcode.com/analytics/v0/daily-usage?start_date=2025-10-15&end_date=2025-10-20" \ -H "Authorization: Bearer " | jq . ``` ### Example Response ```json theme={null} { "daily_usage": [ { "date": "2025-10-15", "metrics": { "total_modified_lines_of_code": 1250, "total_messages": 340, "total_tool_calls": 890, "completions_count": 1500, "completions_accepted": 1120, "completions_lines_of_code": 980, "chat_messages": 85, "remote_agent_messages": 45, "remote_agent_lines_of_code": 120, "ide_agent_messages": 150, "ide_agent_lines_of_code": 95, "cli_agent_interactive_messages": 40, "cli_agent_interactive_lines_of_code": 35, "cli_agent_non_interactive_messages": 20, "cli_agent_non_interactive_lines_of_code": 20 } } ], "metadata": { "effective_start_date": "2025-10-15", "effective_end_date": "2025-10-20", "generated_at": "2025-10-21T10:30:00Z", "total_days": 1 } } ``` ### Response Fields | Field | Type | Description | | --------------------------------------------------------------------- | ------- | ---------------------------------------------------------------- | | daily\_usage | array | Array of daily usage data points (days with no activity omitted) | | daily\_usage\[].date | string | Calendar date (`YYYY-MM-DD`) | | daily\_usage\[].metrics | object | Usage metrics for this date | | daily\_usage\[].metrics.total\_modified\_lines\_of\_code | integer | Total lines of code modified across all interactions | | daily\_usage\[].metrics.total\_messages | integer | Total messages across all interaction types | | daily\_usage\[].metrics.total\_tool\_calls | integer | Total tool calls across all agent types | | daily\_usage\[].metrics.completions\_count | integer | Number of completion requests | | daily\_usage\[].metrics.completions\_accepted | integer | Number of completions accepted by users | | daily\_usage\[].metrics.completions\_lines\_of\_code | integer | Lines of code from completions | | daily\_usage\[].metrics.completions\_suggested\_lines\_of\_code | integer | Lines of code suggested by completions (before acceptance) | | daily\_usage\[].metrics.chat\_messages | integer | Number of chat messages | | daily\_usage\[].metrics.remote\_agent\_messages | integer | Number of Remote Agent messages | | daily\_usage\[].metrics.remote\_agent\_lines\_of\_code | integer | Lines of code from Remote Agent | | daily\_usage\[].metrics.ide\_agent\_messages | integer | Number of IDE Agent messages | | daily\_usage\[].metrics.ide\_agent\_lines\_of\_code | integer | Lines of code from IDE Agent | | daily\_usage\[].metrics.cli\_agent\_interactive\_messages | integer | Number of CLI Agent interactive messages | | daily\_usage\[].metrics.cli\_agent\_interactive\_lines\_of\_code | integer | Lines of code from CLI Agent interactive mode | | daily\_usage\[].metrics.cli\_agent\_non\_interactive\_messages | integer | Number of CLI Agent non-interactive messages | | daily\_usage\[].metrics.cli\_agent\_non\_interactive\_lines\_of\_code | integer | Lines of code from CLI Agent non-interactive mode | | metadata.effective\_start\_date | string | Actual start date used (UTC, after defaults/clamping) | | metadata.effective\_end\_date | string | Actual end date used (UTC, after defaults/clamping) | | metadata.generated\_at | string | Response generation timestamp (ISO 8601) | | metadata.total\_days | integer | Number of days with data in the response | *** ## GET /analytics/v0/user-activity Returns aggregated usage metrics per user over a date range. Users with no activity are omitted. Supports pagination. ### Query Parameters | Parameter | Type | Required | Description | | ----------- | ------- | -------- | ---------------------------------------- | | start\_date | string | No | Start date in `YYYY-MM-DD` format (UTC) | | end\_date | string | No | End date in `YYYY-MM-DD` format (UTC) | | cursor | string | No | Pagination cursor from previous response | | page\_size | integer | No | Number of results per page | ### Date Range Behavior | Scenario | Behavior | | -------------------------- | -------------------------------------------------------------- | | Neither date provided | Returns last 7 days ending at yesterday (UTC) | | Only `start_date` provided | Returns 7 days starting from `start_date`, capped at yesterday | | Only `end_date` provided | Returns 7 days ending at `end_date` | | Both dates provided | Returns the specified inclusive range | ### Pagination | Parameter | Default | Maximum | | ---------- | ------- | ------- | | page\_size | 50 | 100 | To paginate through results: 1. Make initial request (optionally with `page_size`) 2. If `pagination.has_more` is `true`, use `pagination.next_cursor` as the `cursor` parameter 3. Repeat until `has_more` is `false` ### Constraints | Constraint | Value | | --------------------------- | ---------------------------------------------------- | | Maximum date range | 90 days | | Maximum historical lookback | 2 years | | Today and future dates | Not allowed (data available at \~02:00 UTC next day) | | Timezone | All dates interpreted as UTC | ### Example Request ```bash theme={null} curl -s -X GET "https://api.augmentcode.com/analytics/v0/user-activity?start_date=2025-10-15&end_date=2025-10-20&page_size=3" \ -H "Authorization: Bearer " | jq . ``` ### Example Response ```json theme={null} { "users": [ { "user_email": "alice@example.com", "active_days": 5, "metrics": { "total_modified_lines_of_code": 450, "total_messages": 65, "total_tool_calls": 120, "completions_count": 320, "completions_accepted": 280, "completions_lines_of_code": 350, "chat_messages": 25, "remote_agent_messages": 10, "remote_agent_lines_of_code": 45, "ide_agent_messages": 30, "ide_agent_lines_of_code": 40, "cli_agent_interactive_messages": 8, "cli_agent_interactive_lines_of_code": 10, "cli_agent_non_interactive_messages": 5, "cli_agent_non_interactive_lines_of_code": 5 } }, { "user_email": "bob@example.com", "active_days": 3, "metrics": { "total_modified_lines_of_code": 280, "total_messages": 70, "total_tool_calls": 75, "completions_count": 150, "completions_accepted": 120, "completions_lines_of_code": 180, "chat_messages": 40, "remote_agent_messages": 5, "remote_agent_lines_of_code": 25, "ide_agent_messages": 20, "ide_agent_lines_of_code": 55, "cli_agent_interactive_messages": 3, "cli_agent_interactive_lines_of_code": 15, "cli_agent_non_interactive_messages": 2, "cli_agent_non_interactive_lines_of_code": 5 } }, { "service_account_name": "ci-bot", "active_days": 6, "metrics": { "total_modified_lines_of_code": 200, "total_messages": 50, "total_tool_calls": 85, "completions_count": 0, "completions_accepted": 0, "completions_lines_of_code": 0, "chat_messages": 0, "remote_agent_messages": 0, "remote_agent_lines_of_code": 0, "ide_agent_messages": 0, "ide_agent_lines_of_code": 0, "cli_agent_interactive_messages": 0, "cli_agent_interactive_lines_of_code": 0, "cli_agent_non_interactive_messages": 50, "cli_agent_non_interactive_lines_of_code": 200 } } ], "pagination": { "next_cursor": "eyJsYXN0X2lkIjoidXNlcjMifQ==", "has_more": true }, "metadata": { "effective_start_date": "2025-10-15", "effective_end_date": "2025-10-20", "generated_at": "2025-10-21T10:30:00Z", "total_days": 6, "returned_user_count": 3 } } ``` ### Response Fields | Field | Type | Description | | -------------------------------------------------------------- | ------- | --------------------------------------------------------------- | | users | array | Array of user activity records (users with no activity omitted) | | users\[].user\_email | string | User's email address (for regular users) | | users\[].service\_account\_name | string | Service account name (for service accounts) | | users\[].active\_days | integer | Number of distinct days with activity in the date range | | users\[].metrics | object | Usage metrics for this user (summed over date range) | | users\[].metrics.total\_modified\_lines\_of\_code | integer | Total lines of code modified across all interactions | | users\[].metrics.total\_messages | integer | Total messages across all interaction types | | users\[].metrics.total\_tool\_calls | integer | Total tool calls across all agent types | | users\[].metrics.completions\_count | integer | Number of completion requests | | users\[].metrics.completions\_accepted | integer | Number of completions accepted | | users\[].metrics.completions\_lines\_of\_code | integer | Lines of code from completions | | users\[].metrics.completions\_suggested\_lines\_of\_code | integer | Lines of code suggested by completions (before acceptance) | | users\[].metrics.chat\_messages | integer | Number of chat messages | | users\[].metrics.remote\_agent\_messages | integer | Number of Remote Agent messages | | users\[].metrics.remote\_agent\_lines\_of\_code | integer | Lines of code from Remote Agent | | users\[].metrics.ide\_agent\_messages | integer | Number of IDE Agent messages | | users\[].metrics.ide\_agent\_lines\_of\_code | integer | Lines of code from IDE Agent | | users\[].metrics.cli\_agent\_interactive\_messages | integer | Number of CLI Agent interactive messages | | users\[].metrics.cli\_agent\_interactive\_lines\_of\_code | integer | Lines of code from CLI Agent interactive mode | | users\[].metrics.cli\_agent\_non\_interactive\_messages | integer | Number of CLI Agent non-interactive messages | | users\[].metrics.cli\_agent\_non\_interactive\_lines\_of\_code | integer | Lines of code from CLI Agent non-interactive mode | | pagination.next\_cursor | string | Cursor for fetching next page (empty if no more results) | | pagination.has\_more | boolean | `true` if more results are available | | metadata.effective\_start\_date | string | Actual start date used (UTC, after defaults/clamping) | | metadata.effective\_end\_date | string | Actual end date used (UTC, after defaults/clamping) | | metadata.generated\_at | string | Response generation timestamp (ISO 8601) | | metadata.total\_days | integer | Total number of days in the queried date range | | metadata.returned\_user\_count | integer | Number of users returned in this page | Each user has either `user_email` or `service_account_name`, never both. *** ## GET /analytics/v0/daily-user-activity-by-editor-language Returns user activity metrics broken down by language and editor for a specific date. Supports pagination. ### Query Parameters | Parameter | Type | Required | Description | | ---------- | ------- | -------- | ------------------------------------------ | | date | string | No | Date to query in `YYYY-MM-DD` format (UTC) | | cursor | string | No | Pagination cursor from previous response | | page\_size | integer | No | Number of results per page | ### Date Behavior | Scenario | Behavior | | ----------------- | ------------------------------------------------------------- | | Date not provided | Defaults to yesterday (UTC) | | Date provided | Returns activity for that date (must be yesterday or earlier) | ### Pagination | Parameter | Default | Maximum | | ---------- | ------- | ------- | | page\_size | 50 | 100 | To paginate through results: 1. Make initial request (optionally with `page_size`) 2. If `pagination.has_more` is `true`, use `pagination.next_cursor` as the `cursor` parameter 3. Repeat until `has_more` is `false` ### Constraints | Constraint | Value | | --------------------------- | ---------------------------------------------------- | | Maximum historical lookback | 2 years | | Today and future dates | Not allowed (data available at \~02:00 UTC next day) | | Timezone | All dates interpreted as UTC | ### Example Request (First Page) ```bash theme={null} curl -X GET "https://api.augmentcode.com/analytics/v0/daily-user-activity-by-editor-language?date=2025-10-15&page_size=50" \ -H "Authorization: Bearer " ``` ### Example Response ```json theme={null} { "records": [ { "user_email": "alice@example.com", "language": "Python", "editor": "VSCode", "metrics": { "total_modified_lines_of_code": 150, "total_messages": 25, "total_tool_calls": 40, "completions_count": 80, "completions_accepted": 65, "completions_lines_of_code": 120, "chat_messages": 10, "remote_agent_messages": 5, "remote_agent_lines_of_code": 15, "ide_agent_messages": 8, "ide_agent_lines_of_code": 12, "cli_agent_interactive_messages": 2, "cli_agent_interactive_lines_of_code": 3, "cli_agent_non_interactive_messages": 0, "cli_agent_non_interactive_lines_of_code": 0 } }, { "user_email": "alice@example.com", "language": "TypeScript", "editor": "VSCode", "metrics": { "total_modified_lines_of_code": 80, "total_messages": 12, "total_tool_calls": 18, "completions_count": 45, "completions_accepted": 38, "completions_lines_of_code": 60, "chat_messages": 5, "remote_agent_messages": 2, "remote_agent_lines_of_code": 8, "ide_agent_messages": 4, "ide_agent_lines_of_code": 10, "cli_agent_interactive_messages": 1, "cli_agent_interactive_lines_of_code": 2, "cli_agent_non_interactive_messages": 0, "cli_agent_non_interactive_lines_of_code": 0 } } ], "pagination": { "next_cursor": "eyJsYXN0X2lkIjoidXNlcjMifQ==", "has_more": true }, "metadata": { "effective_date": "2025-10-15", "generated_at": "2025-10-16T10:30:00Z", "returned_record_count": 2 } } ``` ### Example Request (Next Page) ```bash theme={null} curl -X GET "https://api.augmentcode.com/analytics/v0/daily-user-activity-by-editor-language?date=2025-10-15&page_size=50&cursor=eyJsYXN0X2lkIjoidXNlcjMifQ==" \ -H "Authorization: Bearer " ``` ### Response Fields | Field | Type | Description | | ---------------------------------------------------------------- | ------- | --------------------------------------------------------------- | | records | array | Array of user/language/editor activity records | | records\[].user\_email | string | User's email address (for regular users) | | records\[].service\_account\_name | string | Service account name (for service accounts) | | records\[].language | string | Programming language (e.g., "Python", "TypeScript", "Unknown") | | records\[].editor | string | Editor/IDE name (e.g., "VSCode", "JetBrains", "CLI", "Unknown") | | records\[].metrics | object | Usage metrics for this user/language/editor combination | | records\[].metrics.total\_modified\_lines\_of\_code | integer | Total lines of code modified across all interactions | | records\[].metrics.total\_messages | integer | Total messages across all interaction types | | records\[].metrics.total\_tool\_calls | integer | Total tool calls across all agent types | | records\[].metrics.completions\_count | integer | Number of completion requests | | records\[].metrics.completions\_accepted | integer | Number of completions accepted | | records\[].metrics.completions\_lines\_of\_code | integer | Lines of code from completions | | records\[].metrics.completions\_suggested\_lines\_of\_code | integer | Lines of code suggested by completions (before acceptance) | | records\[].metrics.chat\_messages | integer | Number of chat messages | | records\[].metrics.remote\_agent\_messages | integer | Number of Remote Agent messages | | records\[].metrics.remote\_agent\_lines\_of\_code | integer | Lines of code from Remote Agent | | records\[].metrics.ide\_agent\_messages | integer | Number of IDE Agent messages | | records\[].metrics.ide\_agent\_lines\_of\_code | integer | Lines of code from IDE Agent | | records\[].metrics.cli\_agent\_interactive\_messages | integer | Number of CLI Agent interactive messages | | records\[].metrics.cli\_agent\_interactive\_lines\_of\_code | integer | Lines of code from CLI Agent interactive mode | | records\[].metrics.cli\_agent\_non\_interactive\_messages | integer | Number of CLI Agent non-interactive messages | | records\[].metrics.cli\_agent\_non\_interactive\_lines\_of\_code | integer | Lines of code from CLI Agent non-interactive mode | | pagination.next\_cursor | string | Cursor for fetching next page (empty if no more results) | | pagination.has\_more | boolean | `true` if more results are available | | metadata.effective\_date | string | Actual date used (UTC, after defaults) | | metadata.generated\_at | string | Response generation timestamp (ISO 8601) | | metadata.returned\_record\_count | integer | Number of records returned in this page | Each record has either `user_email` or `service_account_name`, never both. A single user may have multiple records if they used different language/editor combinations on the queried date. *** ## Rate Limiting The Analytics API enforces rate limits to ensure fair usage and system stability. | Limit Type | Value | | ------------------- | ------------------ | | Requests per minute | 10 requests/minute | | Burst allowance | 20 requests | When you exceed the rate limit, the API returns HTTP status code `429 Too Many Requests`. Your requests will be blocked for the duration specified above before you can make new requests. ### Best Practices 1. **Batch your requests**: Instead of making many small requests, use larger date ranges (up to 90 days) to retrieve more data per request. 2. **Implement exponential backoff**: If you receive a `429` response, wait before retrying. Start with a short delay and increase it with each consecutive failure. 3. **Cache responses**: Analytics data is updated only once daily, so cache responses and avoid re-fetching the same data within a 24-hour period. 4. **Use pagination efficiently**: When paginating through large result sets, process each page before requesting the next one rather than fetching all pages as fast as possible. 5. **Spread requests over time**: If you need to make multiple API calls, distribute them evenly rather than sending them all at once. *** ## Error Responses The API returns standard HTTP status codes: | Status Code | Description | | ----------- | ------------------------------------------------------------------ | | 400 | Invalid request (e.g., invalid date format, range exceeds 90 days) | | 401 | Missing or invalid authentication token | | 403 | Insufficient permissions | | 429 | Too many requests (rate limit exceeded) | | 500 | Internal server error | ### Example Error Response ```json theme={null} { "error": { "code": "InvalidArgument", "message": "end_date cannot be later than yesterday (UTC)" } } ``` --- # Source: https://docs.augmentcode.com/cli/setup-auggie/authentication.md > ## Documentation Index > Fetch the complete documentation index at: https://docs.augmentcode.com/llms.txt > Use this file to discover all available pages before exploring further. # Login and authentication > You will need an active account and valid session token to use Auggie CLI which you can get by following the instructions below. ## About authentication Before you can use Auggie, you will need to login to create a session token that can be used by Auggie in both interactive and automation modes. Augment authentication tokens are secrets and should be protected with the same level of security you'd use for any sensitive credential. Tokens are tied to the user who logged in, not to your team or enterprise account, so each user has a unique augment token. ## Logging in You can login by running the following command and following the prompts. ```sh theme={null} auggie login ``` ## Logging out You can logout by running the following command. This will remove the local token from your machine and you will need to login again to use Auggie. ```sh theme={null} auggie logout ``` ## Getting your token For automation, you will need to provide your token each time you run Auggie. After you have logged in above, you can get your token by running the following command. ```sh theme={null} auggie tokens print ``` ## Using your token After you have your token, you can pass it to Auggie through a number of methods depending on your use case and environment. ### Environment variables You can set the `AUGMENT_SESSION_AUTH` environment variable to your token before running Auggie. Pass it before you run the command, add it to your environment, or add it to your shell's rc file to persist it. ```sh theme={null} AUGMENT_SESSION_AUTH='' ``` ### Token file You can store the token as plaintext in a file and then use the `--augment-token-file` flag to pass it to Auggie. We do not recommend checking your token into version control. ```sh theme={null} auggie --augment-token-file /path/to/token ``` ## Revoking your tokens You can expire all the tokens for the current logged in user by running the following command. Using `--logout` will only remove the local token from your machine. ```sh theme={null} auggie tokens revoke ``` --- # Source: https://docs.augmentcode.com/codereview/auto-generated-pr-descriptions.md > ## Documentation Index > Fetch the complete documentation index at: https://docs.augmentcode.com/llms.txt > Use this file to discover all available pages before exploring further. # Auto-Generated PR Descriptions > Generates comprehensive PR descriptions using Augment Code's Context Engine. After Augment Code Review has reviewed your pull request, it will leave a comment summarizing the work to that point. This description saves reviewers time by handling the 'what' and 'how' of the changes, allowing them to focus on explaining the 'why' and the broader context. The result: faster reviews, better collaboration, and more time on building. ## How It Works 1. **Create Your PR**: Open a pull request in GitHub with your code changes 2. **Automatic Analysis**: Augment's Context Engine analyzes your code diff and understands the changes in the context of your entire codebase 3. **Description Generation**: A comprehensive PR description is automatically generated, covering what changed, how it works, and potential impacts 4. **Review and Edit**: Review the generated description and add any additional context about why the changes were made 5. **Faster Reviews**: Reviewers can quickly understand your changes and provide meaningful feedback ## Best Practices **Review Before Accepting**: Always review the auto-generated description to ensure accuracy and completeness. The AI understands your code, but you understand the business context. **Add the 'Why'**: Supplement the generated description with the reasoning behind your changes. This helps reviewers understand not just what changed, but why it matters. **Keep PRs Focused**: Smaller, focused PRs result in more accurate and useful descriptions. Avoid mixing unrelated changes in a single PR. **Update for Significant Changes**: If you make substantial changes to your PR after the description is generated, consider regenerating or manually updating the description. **Use as a Starting Point**: Treat the auto-generated description as a foundation. Enhance it with project-specific context, design decisions, and any nuances the AI might miss. **Give Reviewers Context**: Give reviewers comprehensive context upfront, leading to faster and more thorough reviews. At the same time, help new team members understand changes more quickly with detailed, consistent PR descriptions. --- # Source: https://docs.augmentcode.com/context-services/context-connectors/quickstart/auto-index-webhook.md > ## Documentation Index > Fetch the complete documentation index at: https://docs.augmentcode.com/llms.txt > Use this file to discover all available pages before exploring further. # Auto-Index with Webhooks > Set up a custom webhook server to re-index on push (advanced) in 10 minutes **Experimental API** - Context Connectors is experimental and subject to breaking changes. ## Prerequisites * A Vercel account (or Express server) * Augment API credentials * AWS credentials + S3 bucket * A GitHub repo you control ## Steps ### 1. Create a Vercel project ```bash theme={null} npx create-next-app@latest my-webhook --typescript --app cd my-webhook npm install @augmentcode/context-connectors @aws-sdk/client-s3 ``` ### 2. Create the webhook handler Create `app/api/webhook/route.ts`: ```typescript theme={null} import { createVercelHandler } from "@augmentcode/context-connectors/integrations/vercel"; import { S3Store } from "@augmentcode/context-connectors/stores"; const store = new S3Store({ bucket: process.env.INDEX_BUCKET! }); export const POST = createVercelHandler({ store, secret: process.env.GITHUB_WEBHOOK_SECRET!, shouldIndex: (event) => event.ref === "refs/heads/main", }); ``` ### 3. Set environment variables in Vercel ``` AUGMENT_API_TOKEN=your-token AUGMENT_API_URL=https://your-tenant.api.augmentcode.com/ GITHUB_WEBHOOK_SECRET=your-secret INDEX_BUCKET=my-indexes AWS_ACCESS_KEY_ID=your-key AWS_SECRET_ACCESS_KEY=your-secret ``` ### 4. Deploy ```bash theme={null} npx vercel --prod ``` Note the URL (e.g., `https://my-webhook.vercel.app`). ### 5. Configure GitHub webhook 1. Go to your repo → Settings → Webhooks → Add webhook 2. Payload URL: `https://my-webhook.vercel.app/api/webhook` 3. Content type: `application/json` 4. Secret: same as `GITHUB_WEBHOOK_SECRET` 5. Events: Just the push event 6. Click "Add webhook" ### 6. Test it Push a commit to main. Check Vercel logs for: ``` Indexed myorg/myrepo: 142 files indexed ``` ## Done! Your index updates automatically on every push to main. ## Also Works With | Instead of... | Try... | | ---------------- | -------------------------------------------------------------------------- | | Vercel | Express: `createExpressHandler()` from `integrations/express` | | Vercel | Any framework: `createGitHubWebhookHandler()` + `verifyWebhookSignature()` | | Main branch only | Customize `shouldIndex` to match any branch pattern | | S3 storage | `FilesystemStore` for local/self-hosted setups | --- # Source: https://docs.augmentcode.com/cli/autoupgrade.md > ## Documentation Index > Fetch the complete documentation index at: https://docs.augmentcode.com/llms.txt > Use this file to discover all available pages before exploring further. # Automatic Updates > Learn how to manage and troubleshoot Auggie CLI's automatic update feature. ## How Automatic Updates Work Auggie CLI automatically updates itself when running in interactive mode to ensure you always have the latest features and bug fixes. ### Interactive Mode (TUI) * Automatically checks npm for newer versions when you start Auggie * Performs upgrades without prompting to minimize interruption * Shows a brief notification when an update is applied * Best-effort approach - continues running even if update fails ### Non-interactive Mode (Print/Text Mode) * Auto-update is completely disabled * Respects version pinning in automation scripts ## Disabling Automatic Updates Set the `AUGMENT_DISABLE_AUTO_UPDATE` environment variable to `1` to disable automatic updates. ### Environment Variable (Recommended for Scripts) ```bash theme={null} # Disable for current session export AUGMENT_DISABLE_AUTO_UPDATE=1 # Disable for single command AUGMENT_DISABLE_AUTO_UPDATE=1 auggie --print "Your instruction here" ``` ## Manual Updates You can manually update Auggie CLI by running the following command. ```bash theme={null} auggie upgrade ``` --- # Source: https://docs.augmentcode.com/models/available-models.md > ## Documentation Index > Fetch the complete documentation index at: https://docs.augmentcode.com/llms.txt > Use this file to discover all available pages before exploring further. # Available Models > The LLMs currently available in Augment and how we use them. ## Current models Augment uses world-class large language models together with our Context Engine. We currently support the following models: * Claude Haiku 4.5 by Anthropic * Claude Opus 4.5 by Anthropic * Claude Sonnet 4 by Anthropic * Claude Sonnet 4.5 by Anthropic * GPT-5.1 by OpenAI * GPT-5.2 by OpenAI ## Choosing a model You can select the model directly using the Model Picker in the Augment. * In VS Code and JetBrains, open the Augment panel and use the model dropdown near the input box to switch models. * In Auggie CLI, use the `/model` slash command or pass the `--model` flag with the desired model. * Your selection applies only to Agent in that workspace and can be changed at any time. If you don't pick a model, Augment will use your last selection or the default set by your organization. ## Model pricing Augment uses a credit-based pricing system. Different models consume credits at different rates based on their capabilities and costs: * **Sonnet 4.5**: Baseline credit consumption for balanced, complex tasks * **Opus 4.5**: \~167% of Sonnet's cost - most capable model for the hardest tasks * **Haiku 4.5**: \~30% of Sonnet's cost - ideal for quick, simple tasks * **GPT-5.1**: \~75% of Sonnet's cost - great for medium-complexity work * **GPT-5.2**: \~133% of Sonnet's cost - enhanced reasoning for complex tasks Learn more about credit costs, see detailed examples, and discover tips for optimizing your credit usage ## Feature compatibility Both models support the core Augment Agent features: * Deep code understanding with Augment's Context Engine * Tool use (integrations and MCP), file edits, and multi-step planning Some behaviors (e.g., wording or style) may vary slightly between models. We'll continue to refine prompts and guardrails to provide a consistent developer experience. ## Notes and transparency * We may roll out model updates gradually. If you're part of a staged rollout, different workspaces or teammates may see updates at different times. * For troubleshooting, you can share the request ID with our support team; they can confirm which model handled a specific request. If you have questions about model availability or want to participate in early access programs, please reach out via Support. --- # Source: https://docs.augmentcode.com/using-augment/chat-actions.md # Source: https://docs.augmentcode.com/jetbrains/using-augment/chat-actions.md > ## Documentation Index > Fetch the complete documentation index at: https://docs.augmentcode.com/llms.txt > Use this file to discover all available pages before exploring further. # Using Actions in Chat > Actions let you take common actions on code blocks without leaving Chat. Explain, improve, or find everything you need to know about your codebase. export const ArrowUpIcon = () =>
; export const Keyboard = ({shortcut}) => {shortcut} ; Augment Chat Actions ## Using actions in Chat To use a quick action, you an use a command or click the up arrow iconto show the available actions. For explain, fix, and test actions, first highlight the code in the editor and then use the command. | Action | Usage | | :------------------------------- | :----------------------------------------------------------------------- | | | Use natural language to find code or functionality | | | Augment will explain the hightlighted code | | | Augment will suggest improvements or find errors in the highlighted code | | | Augment will suggest tests for the highlighted code | Augment will typically include code blocks in the response to the action. See [Applying code blocks from Chat](/using-augment/chat-apply) for more details. --- # Source: https://docs.augmentcode.com/using-augment/chat-apply.md # Source: https://docs.augmentcode.com/jetbrains/using-augment/chat-apply.md > ## Documentation Index > Fetch the complete documentation index at: https://docs.augmentcode.com/llms.txt > Use this file to discover all available pages before exploring further. # Applying code blocks from Chat > Use Chat to explore your codebase, quickly get up to speed on unfamiliar code, and get help working through a technical problem. export const MoreVertIcon = () =>
; export const CheckIcon = () =>
; export const FileNewIcon = () =>
; export const FileCopyIcon = () =>
; Augment Chat Apply ## Using code blocks from within Chat Whenever Chat responds with code, you will have the option to add the code to your codebase. The most common option will be shown as a button and you can access the other options by clicking the overflow menu iconat the top-right of the code block. You can use the following options to apply the code: * **Copy** the code from the block to your clipboard * **Create** a new file with the code from the block * **Apply** the code from the block intelligently to your file --- # Source: https://docs.augmentcode.com/using-augment/chat-context.md # Source: https://docs.augmentcode.com/jetbrains/using-augment/chat-context.md > ## Documentation Index > Fetch the complete documentation index at: https://docs.augmentcode.com/llms.txt > Use this file to discover all available pages before exploring further. # Focusing Context in Chat > You can specify context from files, folders, and external documentation in your conversation to focus your chat responses. export const AtIcon = () =>
; export const Command = ({text}) => {text}; ## About Chat Context Augment intelligently includes context from your entire workspace based on the ongoing conversation–even if you don't have the relevant files open in your editor–but sometimes you want Augment to prioritize specific details for more relevant responses.