Skip to content

Getting started

Sign in

Open the app and sign in with Google, or with the username and password your administrator gave you.

If you sign in with Google and don't have an account yet, the app records an access request and emails the owner. You'll get an email once you've been added.

Your access level and permissions are under My profile (the menu at the top right). That's also where you change your password or switch your account to Google sign-in only.

Connect a GitHub repository

Lyzentra only works in repositories you connect. Connected projects are private to you and the people you share them with.

  1. Open My connections and click Connect GitHub.
  2. GitHub asks you to install the app. Pick the repositories Lyzentra may use and confirm.
  3. Back in the app, under Add from GitHub, find the repository, give the project a name and add it.

To give Lyzentra more repositories later, click Choose repositories on the same page.

Connect a GitLab project

Works with gitlab.com and with your company's own GitLab server.

  1. Open My connections. In the GitLab section, click Sign in with GitLab if you see it. Otherwise click Connect with a token.
  2. For a token: enter your GitLab address (leave https://gitlab.com for gitlab.com), then click Create one. GitLab opens its token page with the name and the api scope already filled in. Create the token, copy it, paste it into Lyzentra and click Connect.
  3. Under Add from GitLab, pick the project and click Add GitLab project. The list shows the projects your account can push to (Developer access or more).

Lyzentra adds a webhook to the project so that labelled issues and /agent comments start right away. That needs Maintainer access. Without it the project still works; you start issues from the app instead.

The token is stored encrypted and is only used by the server. You can disconnect the account at any time, and revoke the token in GitLab under Preferences → Access tokens.

Connect a Jira project

Issues can come from Jira while the code goes to one of your GitHub or GitLab repositories, so connect GitHub or GitLab first.

  1. Click Connect Jira and allow access to your Jira site.
  2. Under Add from Jira, pick the site, the Jira project, and the GitHub repository or GitLab project the code should go to.

Connect Linear, Trello, Asana or ClickUp

Issues can also come from these trackers, with the code going to one of your GitHub or GitLab repositories.

  1. Open My connections, scroll to Linear, Trello, Asana and ClickUp and pick your tracker.
  2. Create a token in the tracker (the Get one link takes you to the right page) and paste it. Trello needs two values: the API key and a token.
  3. Under Add a …, pick the team (Linear), board (Trello), project (Asana) or list (ClickUp), choose where the code goes, and add it.

Mark issues with the label (or tag) ai-agent, then start them from the Issues page. Lyzentra comments on the issue and moves it through your columns: it looks for names like In progress, Review and Done.

Your first run

On GitHub or GitLab, add the label ai-agent to an issue in a connected project. Lyzentra starts right away; you'll see the job under Activity.

For Jira, adding the label starts work right away too, if your administrator has turned on Jira webhooks. Otherwise, start Jira issues from the app: open Issues, pick the project, open the issue and click Run pipeline.... See Starting work.

The issue needs to say which repository the change is for. In a connected GitHub project that's automatic. For other projects, put the repository URL in the description, e.g. https://github.com/acme/shop.

Tip

Write the issue the way you'd write it for a new teammate: what should change, and how you'll know it works. Lyzentra scores how clear an issue is and asks questions when it can't tell.

The guide is always one click away: Help & docs at the bottom of the sidebar.