> ## Documentation Index
> Fetch the complete documentation index at: https://docs.noxus.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Developer Tools

> Integrate with GitHub, Linear, and development platforms

Connect Noxus to your development tools for automated code management, issue tracking, and project coordination.

## Supported Developer Tools

| Tool       | Authentication                | Key Capabilities                                 |
| :--------- | :---------------------------- | :----------------------------------------------- |
| **GitHub** | OAuth / Personal Access Token | Repositories, issues, PRs, actions, code reviews |
| **Linear** | API Key                       | Issues, projects, teams, workflows               |
| **GitLab** | Personal Access Token         | Repositories, merge requests, pipelines          |

***

## GitHub Integration

### Authentication Methods

<Tabs>
  <Tab title="OAuth (Recommended)">
    **User-delegated access to GitHub resources**

    <Steps>
      <Step title="Navigate to Integrations">
        Go to Integrations in Noxus
      </Step>

      <Step title="Select GitHub">
        Click Connect on GitHub integration
      </Step>

      <Step title="Authorize">
        Sign in to GitHub and authorize Noxus
      </Step>

      <Step title="Select Permissions">
        Choose which repositories and permissions to grant
      </Step>

      <Step title="Complete">
        Connection is ready to use
      </Step>
    </Steps>

    **Permissions:**

    * Repository access (read/write)
    * Issue management
    * Pull request operations
    * Workflow dispatch
  </Tab>

  <Tab title="Personal Access Token">
    **Token-based authentication for fine-grained control**

    <Steps>
      <Step title="Generate Token">
        In GitHub: Settings → Developer settings → Personal access tokens → Generate new token
      </Step>

      <Step title="Select Scopes">
        Choose required scopes (repo, workflow, etc.)
      </Step>

      <Step title="Copy Token">
        Copy the generated token
      </Step>

      <Step title="Configure in Noxus">
        Enter token in GitHub integration settings
      </Step>

      <Step title="Test Connection">
        Verify the connection works
      </Step>
    </Steps>

    <Warning>
      Personal Access Tokens provide broad access. Use OAuth for better security when possible.
    </Warning>
  </Tab>
</Tabs>

### Capabilities

<AccordionGroup>
  <Accordion title="Repository Operations" icon="git-branch">
    * Clone and fetch repositories
    * Read file contents
    * Create and update files
    * Manage branches
    * Access commit history
  </Accordion>

  <Accordion title="Issue Management" icon="clipboard-pen-line">
    * Create and update issues
    * Add comments and labels
    * Assign to users
    * Link to pull requests
    * Search and filter issues
  </Accordion>

  <Accordion title="Pull Requests" icon="git-pull-request">
    * Create pull requests
    * Review and comment on PRs
    * Approve or request changes
    * Merge pull requests
    * Trigger CI/CD workflows
  </Accordion>

  <Accordion title="Actions & Workflows" icon="zap">
    * Trigger GitHub Actions
    * Monitor workflow runs
    * Access run logs
    * Dispatch repository events
  </Accordion>
</AccordionGroup>

### Common Use Cases

<Tabs>
  <Tab title="Automated Code Review">
    **AI-powered code review workflows:**

    ```mermaid theme={null}
    graph LR
        A[PR Created] --> B[Fetch Code Changes]
        B --> C[AI Analysis]
        C --> D[Post Review Comment]
        D --> E[Request Changes/Approve]
    ```

    * Analyze code changes with AI
    * Check for security issues
    * Enforce coding standards
    * Automated suggestions
  </Tab>

  <Tab title="Issue Automation">
    **Automate issue management:**

    ```mermaid theme={null}
    graph LR
        A[External Input] --> B[Process Data]
        B --> C[Create GitHub Issue]
        C --> D[Assign & Label]
        D --> E[Notify Team]
    ```

    * Create issues from customer feedback
    * Auto-assign based on content
    * Label and categorize automatically
    * Link to related issues
  </Tab>

  <Tab title="Release Management">
    **Automate release processes:**

    ```mermaid theme={null}
    graph LR
        A[Tag Created] --> B[Generate Changelog]
        B --> C[Create Release]
        C --> D[Notify Stakeholders]
    ```

    * Generate release notes
    * Update documentation
    * Notify stakeholders
    * Trigger deployment workflows
  </Tab>
</Tabs>

***

## Linear Integration

### Authentication: API Key

Linear uses API key authentication for secure access to your workspace.

<Steps>
  <Step title="Generate API Key">
    In Linear: Settings → API → Create new key
  </Step>

  <Step title="Copy Key">
    Copy the generated API key
  </Step>

  <Step title="Configure in Noxus">
    Go to Integrations → Linear → Enter API key
  </Step>

  <Step title="Save">
    Save the connection
  </Step>
</Steps>

### Capabilities

<AccordionGroup>
  <Accordion title="Issue Management" icon="clipboard-pen-line">
    * Create and update issues
    * Manage issue status and priority
    * Assign to team members
    * Add comments and attachments
    * Set estimates and due dates
  </Accordion>

  <Accordion title="Project Tracking" icon="briefcase">
    * Create and manage projects
    * Track project progress
    * Organize with milestones
    * View project roadmaps
  </Accordion>

  <Accordion title="Team Operations" icon="users">
    * Access team information
    * View team members
    * Get team workflows
    * Track team capacity
  </Accordion>
</AccordionGroup>

### Common Use Cases

<Tabs>
  <Tab title="Automated Triage">
    **Automatically triage and route issues:**

    ```mermaid theme={null}
    graph LR
        A[Issue Created] --> B[AI Categorize]
        B --> C[Assign Team]
        C --> D[Set Priority]
        D --> E[Add Labels]
    ```

    * AI-powered categorization
    * Smart team assignment
    * Priority detection
    * Auto-labeling
  </Tab>

  <Tab title="Cross-Platform Sync">
    **Sync with other tools:**

    ```mermaid theme={null}
    graph LR
        A[GitHub Issue] --> B[Transform Data]
        B --> C[Create Linear Issue]
        C --> D[Keep in Sync]
    ```

    * GitHub → Linear sync
    * Slack → Linear issue creation
    * Email → Linear tasks
  </Tab>
</Tabs>

***

## Security Best Practices

<CardGroup cols={2}>
  <Card title="Token Management" icon="key">
    * Generate separate tokens per integration
    * Rotate tokens regularly
    * Revoke unused tokens
    * Monitor token usage
  </Card>

  <Card title="Permission Scoping" icon="shield">
    * Use minimum required permissions
    * Regular permission audits
    * Separate tokens for different environments
    * Document token purposes
  </Card>
</CardGroup>

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="Authentication Failed" icon="circle-x">
    **Possible Causes:**

    * Invalid API token or key
    * Token revoked or expired
    * Incorrect credentials
    * Network connectivity issues

    **Solutions:**

    * Generate a new token
    * Verify credentials are correct
    * Check token hasn't been revoked
    * Test connection manually
  </Accordion>

  <Accordion title="Permission Denied" icon="shield-x">
    **Possible Causes:**

    * Insufficient permissions
    * Repository/project access restrictions
    * Organization policies
    * Token scope limitations

    **Solutions:**

    * Verify token has required scopes
    * Check repository/project permissions
    * Review organization settings
    * Use OAuth for broader access (GitHub)
  </Accordion>

  <Accordion title="Rate Limit Exceeded" icon="gauge">
    **Possible Causes:**

    * Too many API requests
    * Concurrent operations
    * Bulk data operations

    **Solutions:**

    * Implement rate limiting in flows
    * Use batch operations
    * Add delays between requests
    * Upgrade API limits if available
  </Accordion>
</AccordionGroup>

***

## Next Steps

<CardGroup cols={3}>
  <Card title="Collaboration Tools" icon="message-circle" href="/integrations/providers/collaboration">
    Connect Slack, Notion, and team tools
  </Card>

  <Card title="Microsoft 365" icon="building" href="/integrations/providers/microsoft">
    Integrate with Microsoft services
  </Card>

  <Card title="All Integrations" icon="blocks" href="/integrations/catalog">
    Browse the complete catalog
  </Card>
</CardGroup>