# Entire

> Connect Entire for the Coder: how to copy your token from the Entire command line, where to paste it, how the Coder clones and pushes, and how to fix the usual errors.

Connect Entire and the Coder works on your Entire repositories the way it works on GitHub: it copies a repository into its own [workspace](/docs/workspaces/files), makes the change, and pushes it to a branch of its own for you to review.

> [!IMPORTANT]
> Entire connects on stellarfirm.ai, under [Integrations](https://stellarfirm.ai/app/integrations). It is not in the desktop app yet.

## At a glance

| | |
| --- | --- |
| Category | Source control |
| Used by | Coder |
| Connect in | Integrations, on stellarfirm.ai |
| What you paste | One token, copied from the Entire command line |
| Works with | Repositories in your Entire projects |

## What assistants can do

| Ability | How it runs |
| --- | --- |
| Copy a repository into its workspace | Runs on its own |
| Fetch new work from a repository | Runs on its own |
| Push a branch with its work | Runs on its own, to a branch under `stellarfirm/coder/` only |
| Merge or deploy | Waits for your [Approve](/docs/ceo/approvals) |

The Coder never pushes to your default branch and never force pushes.

## Copy your token

The token comes from the Entire command line on your own computer.

1. Install the Entire command line, then run `entire login` and sign in.
2. Copy the token straight to your clipboard:

   ```bash
   entire auth token | tr -d '\n' | pbcopy
   ```

   On Linux, use `xclip -selection clipboard` in place of `pbcopy`.

> [!TIP]
> Copy it with that command, not by selecting the text in your terminal. The token is one long line, and a terminal that wraps it can add line breaks when you copy it by hand. A token with a line break in it is refused by Entire.

The token works for everything your Entire account can reach, and it lasts a few hours. When it runs out, the Coder's next clone or push stops with a sign-in error: copy a new one the same way and paste it again.

## Connect it in StellarFirm

1. Sign in at [stellarfirm.ai/app](https://stellarfirm.ai/app).
2. Open **Integrations** and pick **Entire**.
3. Paste the token into **Token**.
4. Make sure **Use live Entire** is on, then press **Connect** (or **Save changes** if a token was saved before).
5. The switch reads **Your assistants use this integration.** Your token is stored encrypted in StellarFirm cloud, is never shown back to you, and is handed to one git command at a time.

## Tell the Coder where to work

The Coder needs the repository's Entire clone address. To see it, run `entire repo clone /et/<project>/<repository>` on your computer, or copy it from the repository's page on Entire. It looks like this:

```text
https://<region>.entire.io/et/<project>/<repository>.git
```

Name that address in your message:

```prompt title="First test"
Coder, Entire is connected. Clone https://<region>.entire.io/et/<project>/<repository>.git, create the branch stellarfirm/coder/entire-test, add one empty commit, and push only that branch. Change no files.
```

When that branch shows up on Entire, the connection works end to end.

## Good to know

- **Your house rules still apply.** Pushing the Coder's own branch runs on its own. A merge, a deploy, a delete, and anything that spends money wait for your Approve. See [house rules](/docs/ceo/house-rules).
- **One command at a time.** StellarFirm hands the token to a git command only when the command is git and nothing else: no pipes, scripts, or other programs on the same line. A command like `git clone ... | tail` runs without it and fails to sign in.
- **Switch it off at any time.** Turn off **Use live Entire** to pause it, or choose **Turn off** to remove the token. Signing out of the Entire command line on your computer does not remove the copy saved in StellarFirm.

## Troubleshooting

| What you see | What it means | What to do |
| --- | --- | --- |
| `could not read Username for 'https://...entire.io'` | Entire did not accept the token | Copy a new token with the command above and paste it again |
| The same error with a token that was just saved | The token was copied with a line break, or from another Entire account | Copy it again with `entire auth token \| tr -d '\n' \| pbcopy`, signed in to the account that owns the repository |
| The clone works but the push is refused | The branch is not under `stellarfirm/coder/` | Ask the Coder to push to a `stellarfirm/coder/` branch |
| The Coder says it has no login for Entire | **Use live Entire** is off | Turn it on and press **Save changes** |

## Prompts

```prompt title="Make a change"
Coder, Entire is connected. In https://<region>.entire.io/et/<project>/<repository>.git, [describe the change], and push it to a new stellarfirm/coder/ branch for review.
```

```prompt title="Explain a repository"
Coder, clone https://<region>.entire.io/et/<project>/<repository>.git and give me a short tour: what it does, how it is laid out, and how to run its tests.
```

## Next

- [Connect your code](/docs/getting-started/connect-your-code): the checklist for every code host.
- [House rules](/docs/ceo/house-rules) and [approvals](/docs/ceo/approvals): what waits for you.
- [GitHub](/docs/integrations/github), [GitLab](/docs/integrations/gitlab) and [Bitbucket](/docs/integrations/bitbucket).

---

Source: https://stellarfirm.ai/docs/integrations/entire
