CONNECTOR · GITLAB
Ground every plan in your GitLab code.
A connector is the bridge to your code. This one gives the planning agent read-only access to a GitLab repository, on GitLab.com or on your own self-managed instance, so every Spec fits the product as it works today. You never open the repo. The agent does, and it never changes a line.
What the agent reads
Link a repository and the agent reads your GitLab code while it interviews you, so every Spec fits the product as it works today. Read access only. It never changes a line.
| What Plansmith reads | What it grounds |
|---|---|
| Repository files and folders | Where things live, so a Spec names the real modules instead of a guess |
| File contents on the default branch | How the product works today, so the plan starts from what exists |
| Full-text search across the repository, cloud or self-hosted | The exact places a change lands, before anyone sizes it |
| Framework, styling, and component conventions | A prototype that looks like your product, not a generic mockup |
| The repository you link to a Project | Code context on every Plan in that Project |
| Nothing else | Read access only. The agent never writes, commits, branches, or opens a merge request. |
Three steps to grounded plans
- 1
Connect
Click Connect GitLab and sign in with your GitLab account. The connection belongs to you, not your whole group, and it asks for read access only.
- 2
Link a repository
Pick the repository this Project plans against. The agent reads its default branch. One repository per Project, and you can change it whenever the work moves.
- 3
Plan
Describe what you need. The agent reads the code while it interviews you, so the Specs land on the product you already have. You never open the repo.
Questions, answered
- Can Plansmith change our code?
- No. The connector is read only. The agent lists files, reads them, and searches on the default branch, and that is the entire surface. It never writes, commits, branches, or opens a merge request.
- We run self-managed GitLab. Does that work?
- Yes. Register your instance address once, then connect and link a repository the same way. The instance has to be reachable over public HTTPS, and registering one is an owner's job.
- Can the agent search our code?
- Yes, cloud or self-hosted. The agent searches every file in the repository with the same tools your developers use, and it reads the code while it interviews you.
- Does Plansmith keep a copy of our code?
- Yes, a text copy of the branch you link, so the agent can search all of it. It refreshes when the branch moves and is deleted when you unlink the repository. Through the private-network connector, the copy is built inside your network and then uploaded.
- GitLab calls a repository a project. Which one does Plansmith mean?
- Both words are in play, so here is the mapping. A Plansmith Project is where your Plans live. A GitLab project is the repository you link to it. One repository per Plansmith Project.
- Do I need to connect a repository before I start planning?
- No. Plan first and add code context whenever you want it. A plan without it still produces build-ready specs and prototypes. A plan with it produces Specs that fit the product you already have.
Grounded in your repo, not your imagination.
Other code connectors: GitHub · Bitbucket · All connectors