Quick start

From installation to your first SMART task.

Choose your setup, then run these commands in order. Keep your terminal open as you go.

  1. Install SMART

    Your operating system

    Open Terminal and run the installer.

    Open a new terminal so it picks up SMART, then check that a version is printed.

    Questions at this step

  2. Sign in

    Run this command and complete the browser sign-in with your SMART account. Contact your SMART administrator if you need an account or access.

    Back in the terminal, check that SMART shows the identity you signed in with.

    Questions at this step

  3. Connect Codex

    Your coding agent

    Make sure the Codex command-line tool is installed and available in this terminal. Run these commands one at a time.

    Check that the local SMART service is running. Then restart or reconnect Codex to load its new configuration.

    Questions at this step

  4. Try your first task

    Open an existing project in Codex, check that SMART tools are available, and send this prompt in a new conversation.

    Look for the agent using SMART tools and grounding its recommendation in your project. If SMART returns no guidance, ask your administrator to check your account access.

    Questions at this step

Check your setup

Run these read-only checks in your terminal.

Confirm the installed version, the signed-in identity, and that the local SMART service is running. Check your agent’s tools to confirm the connection.

Connect another agent
Need another command? Open the full command reference.