Skip to main content

​
Get started in three steps

Follow these simple steps to set up your first Agen workspace, launch an AI session, and start syncing code manually or via our CLI.

​
Step 1: Set up your workspace

  1. Navigate to the Agen Web Portal (or your hosted instance).
  2. Sign up or log in to your account.
  3. Create a new Workspace. This is where you will manage your repositories, sessions, and team members.
  1. Inside your new workspace, click on Repositories.
  2. Add the Git repository you want the AI to work on.
  3. Ensure you have provided the necessary branching permissions so the AI can safely create branches or open pull requests.

​
Step 2: Launch an AI Session

  1. Go to the Sessions tab in your workspace.
  2. Click New Session and select the repository you just connected.
  3. Choose the task you want the AI to perform (e.g., “Refactor the authentication module” or “Create a new React component”).
  4. Select your preferred AI model from the options available in your workspace.
  5. Start the session. Agen will automatically spin up a secure, isolated sandbox for the AI to work without affecting your local machine.

​
Step 3: Stream and Sync Code

To watch the AI work in real-time and effortlessly sync file modifications to your local environment, install our CLI:
npm install -g @agenhq/cli
(Note: Ensure you have Node.js installed).
  1. Authenticate the CLI with your Agen account: 
    agen login
  2. Watch the session and sync the patches in real-time: 
    agen watch <SESSION_ID>
  3. As the AI Agent writes and tests code inside the sandbox, you will see the files changing locally in real-time! Review the code, run your own tests, and commit the changes when you are satisfied.

​
Next steps

Now that you have your first AI session running, explore more advanced integrations and tools:

Concept: Secure Sandboxes

Learn how Agen securely isolates AI generated code.

Manage Team & Billing

Learn how to add team members to your workspace and manage usage.

CLI Reference

Deep dive into the Agen CLI commands.