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

# Quickstart

> The cloud software engineer that builds alongside you

export const CodesmithBento = () => <section className="codesmith-bento-wrap" aria-label="Explore [code]smith">
    <h2 className="codesmith-bento-heading">Explore [code]smith</h2>

    <div className="codesmith-bento">
      <a className="codesmith-bento-card codesmith-bento-card--primary" href="/codesmith/build-from-anywhere">
        <div className="codesmith-bento-header">
          <div className="codesmith-bento-compact-icon" aria-hidden="true">
            <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="1.75">
              <circle cx="12" cy="12" r="9" />
              <path d="M3 12h18" strokeLinecap="round" />
              <path d="M12 3a14 14 0 0 1 0 18a14 14 0 0 1 0-18Z" strokeLinecap="round" strokeLinejoin="round" />
            </svg>
          </div>
          <span className="codesmith-bento-eyebrow">Build with [code]smith</span>
        </div>
        <div className="codesmith-bento-copy">
          <p className="codesmith-bento-title">Plan, implement, optimize</p>
          <p className="codesmith-bento-desc">
            Use the web UI or tag @codesmith in GitHub or Slack to start building.
          </p>
          <span className="codesmith-bento-link">Learn more →</span>
        </div>
      </a>

      <a className="codesmith-bento-card" href="/codesmith/integrations">
        <div className="codesmith-bento-header">
          <div className="codesmith-bento-compact-icon" aria-hidden="true">
            <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="1.75">
              <path d="M12 22v-5" strokeLinecap="round" />
              <path d="M9 8V2" strokeLinecap="round" />
              <path d="M15 8V2" strokeLinecap="round" />
              <path d="M5 12h14" strokeLinecap="round" />
              <rect x="3" y="8" width="18" height="9" rx="2" />
            </svg>
          </div>
          <span className="codesmith-bento-eyebrow">Integrations</span>
        </div>
        <div className="codesmith-bento-copy">
          <p className="codesmith-bento-title">Connect</p>
          <p className="codesmith-bento-desc">
            Configure remote MCP or install in an isolated sandbox.          </p>
          <span className="codesmith-bento-link">Explore integrations →</span>
        </div>
      </a>

      <a className="codesmith-bento-card" href="/codesmith/ci-tuning">
        <div className="codesmith-bento-header">
          <div className="codesmith-bento-compact-icon" aria-hidden="true">
            <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="1.75">
              <path d="M12 14a2 2 0 0 0 2-2c0-1.1-2-6-2-6s-2 4.9-2 6a2 2 0 0 0 2 2Z" strokeLinejoin="round" />
              <path d="M5 20a9 9 0 1 1 14 0" strokeLinecap="round" strokeLinejoin="round" />
            </svg>
          </div>
          <span className="codesmith-bento-eyebrow">CI Tuning</span>
        </div>
        <div className="codesmith-bento-copy">
          <p className="codesmith-bento-title">Speed up CI</p>
          <p className="codesmith-bento-desc">
            Analyze jobs and runner sizes to balance speed and cost.
          </p>
          <span className="codesmith-bento-link">Learn more →</span>
        </div>
      </a>

      <a className="codesmith-bento-card" href="/codesmith/autofix">
        <div className="codesmith-bento-header">
          <div className="codesmith-bento-compact-icon" aria-hidden="true">
            <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="1.75">
              <circle cx="12" cy="12" r="9" />
              <path d="M8.5 12.5l2.5 2.5 4.5-5" strokeLinecap="round" strokeLinejoin="round" />
            </svg>
          </div>
          <span className="codesmith-bento-eyebrow">Autofix CI</span>
        </div>
        <div className="codesmith-bento-copy">
          <p className="codesmith-bento-title">Keep PRs green</p>
          <p className="codesmith-bento-desc">
            Automatically address CI failures and review feedback.
          </p>
          <span className="codesmith-bento-link">Learn more →</span>
        </div>
      </a>

      <a className="codesmith-bento-card codesmith-bento-card--pricing" href="/codesmith/pricing-and-faqs">
        <div className="codesmith-bento-header">
          <div className="codesmith-bento-compact-icon" aria-hidden="true">
            <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="1.75">
              <circle cx="12" cy="12" r="9" />
              <path d="M9.1 9a3 3 0 0 1 5.8 1c0 2-3 2.5-3 4.5" strokeLinecap="round" strokeLinejoin="round" />
              <path d="M12 17.25h.01" strokeLinecap="round" />
            </svg>
          </div>
          <span className="codesmith-bento-eyebrow">Pricing</span>
        </div>
        <div className="codesmith-bento-copy">
          <p className="codesmith-bento-title">Pricing & FAQs</p>
          <p className="codesmith-bento-desc">
            Costs, data retention and permissions.
          </p>
          <span className="codesmith-bento-link">View pricing →</span>
        </div>
      </a>
    </div>
  </section>;

export const CodesmithHero = () => <>
    <div className="codesmith-hero-wrap">
      <div className="codesmith-hero" id="overview">
        <img className="codesmith-hero-gif" src="https://pub-e2b06c433e4f400c841be3653e0cad01.r2.dev/peek-large.gif" alt="[code]smith building alongside you" />
      </div>
    </div>

    <div className="codesmith-hero-cta">
      <a className="codesmith-button-slack" href="https://slack.com/oauth/v2/authorize?client_id=6405844366960.10016658702295&amp;scope=assistant:write,app_mentions:read,channels:history,channels:join,channels:read,chat:write,files:read,files:write,groups:history,groups:read,im:history,im:read,im:write,mpim:history,mpim:read,reactions:read,reactions:write,users:read&amp;user_scope=" target="_blank" rel="noopener noreferrer">
        <svg className="codesmith-button-slack-icon" viewBox="0 0 122.8 122.8" aria-hidden="true" focusable="false">
          <path fill="#E01E5A" d="M25.8 77.6c0 7.1-5.8 12.9-12.9 12.9S0 84.7 0 77.6s5.8-12.9 12.9-12.9h12.9v12.9zm6.5 0c0-7.1 5.8-12.9 12.9-12.9s12.9 5.8 12.9 12.9v32.3c0 7.1-5.8 12.9-12.9 12.9s-12.9-5.8-12.9-12.9V77.6z" />
          <path fill="#36C5F0" d="M45.2 25.8c-7.1 0-12.9-5.8-12.9-12.9S38.1 0 45.2 0s12.9 5.8 12.9 12.9v12.9H45.2zm0 6.5c7.1 0 12.9 5.8 12.9 12.9s-5.8 12.9-12.9 12.9H12.9C5.8 58.1 0 52.3 0 45.2s5.8-12.9 12.9-12.9h32.3z" />
          <path fill="#2EB67D" d="M97 45.2c0-7.1 5.8-12.9 12.9-12.9s12.9 5.8 12.9 12.9-5.8 12.9-12.9 12.9H97V45.2zm-6.5 0c0 7.1-5.8 12.9-12.9 12.9s-12.9-5.8-12.9-12.9V12.9C64.7 5.8 70.5 0 77.6 0s12.9 5.8 12.9 12.9v32.3z" />
          <path fill="#ECB22E" d="M77.6 97c7.1 0 12.9 5.8 12.9 12.9s-5.8 12.9-12.9 12.9-12.9-5.8-12.9-12.9V97h12.9zm0-6.5c-7.1 0-12.9-5.8-12.9-12.9s5.8-12.9 12.9-12.9h32.3c7.1 0 12.9 5.8 12.9 12.9s-5.8 12.9-12.9 12.9H77.6z" />
        </svg>
        <span>Add to Slack</span>
      </a>
      <a className="codesmith-button-yellow" href="https://codesmith.sh" target="_blank" rel="noopener noreferrer">
        {"Start building with [code]smith →"}
      </a>
    </div>
  </>;

<CodesmithHero />

\[code]smith is a background coding agent that operates and improves your codebase alongside you.

\[code]smith:

* can be tagged from any surface to start building: GitHub, [Slack](https://slack.com/oauth/v2/authorize?client_id=6405844366960.10016658702295\&scope=assistant:write,app_mentions:read,channels:history,channels:join,channels:read,chat:write,files:read,files:write,groups:history,groups:read,im:history,im:read,im:write,mpim:history,mpim:read,reactions:read,reactions:write,users:read\&user_scope=), or from the [Web UI](https://codesmith.sh).
* knows about all of your repositories, making cross-repo changes with ease.
* has context about your PRs and CI runs, keeping PRs green and optimizing your runner infrastructure for the fastest build times.
* uses the latest models, providing cutting-edge speed and intelligence.

<Info>
  \[code]smith is free until August 15. After that, usage is charged at \$1.75 per [agent compute unit](/codesmith/pricing-and-faqs).

  We'll email your accrued August usage on August 13 so you can map your workload to agent compute units.
</Info>

<CodesmithBento />