# How to Connect GitHub to Lookout



<blockquote class="announcement">
  <div class="tip-quote">
    
    <div class="tip-text"><strong>Rudder Lookout</strong> is currently in <strong>Public Beta</strong>. <a href="mailto:product@rudderstack.com" >Contact the Product team</a> if you have any questions.</div>
  </div>
</blockquote>

<p>Connecting GitHub gives the agent one more place to look when it is working out what your data means: the code that produces it.</p>

<html lang="en">
<blockquote class="info">
  <div class="tip-quote">
    
    <div class="tip-text">The GitHub connection is <strong>read-only</strong>. Lookout reads your repositories for context. It cannot open pull requests, create branches, commit, or leave review comments — there is no tool for any of that.</div>
  </div>
</blockquote>

</html>
<!-- end-chunk -->
<!-- begin-chunk -->
<h2 id="connect-github">Connect GitHub</h2><p>Only admins can connect GitHub. Once connected, any member can use the repository tools in chat. See <a href="https://www.rudderstack.com/docs/activate/lookout/workspaces/roles/" >Roles and Permissions</a> for more details.</p>
<p>From <strong>Settings</strong> &gt; <strong>Connections</strong> &gt; <strong>Source Control</strong>, install the <strong>Lookout GitHub App</strong> and grant it access to the repositories you want Lookout to read.</p>
<p>Then link each repository to the warehouse it belongs to under <strong>Settings</strong> &gt; <strong>Connections</strong> &gt; <strong>Warehouses</strong>, so Lookout knows which repository describes which data. See <a href="https://www.rudderstack.com/docs/activate/lookout/integrations/sources/" >Link Repositories to Warehouses</a>.</p>
<!-- end-chunk -->
<!-- begin-chunk -->
<h2 id="what-the-agent-can-read">What the agent can read</h2><ul>
<li><strong>Files and code</strong>: Read files and search across a repository</li>
<li><strong>History</strong>: List commits and see what changed</li>
<li><strong>Pull requests</strong>: List them and read their diffs, as a record of how something came to be</li>
</ul>
<p>Repository access is scoped to what you granted the app, and to the repositories linked in your workspace.</p>
<!-- end-chunk -->
<!-- begin-chunk -->
<h2 id="keep-documentation-current">Keep documentation current</h2><p>When a push lands on the default branch of a linked repository, Lookout refreshes the generated documentation for that project, so what the agent reads stays in step with your code. That documentation lives in the <a href="https://www.rudderstack.com/docs/activate/lookout/working-with-lookout/context-hub/" >Context Hub</a>.</p>
<br />

