create-urateam 0.1.7 → 0.1.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json
CHANGED
|
@@ -3,7 +3,11 @@ LINEAR_API_KEY=
|
|
|
3
3
|
LINEAR_WEBHOOK_SECRET=
|
|
4
4
|
LINEAR_TEAM_ID=
|
|
5
5
|
|
|
6
|
-
# Repository
|
|
6
|
+
# Repository — REQUIRED to boot. `ura dev` and `ura start` exit with an
|
|
7
|
+
# error if REPO_TEAM_ID or REPO_URL are missing or blank. Without these
|
|
8
|
+
# the webhook server otherwise starts looking healthy but silently fails
|
|
9
|
+
# every inbound Linear event with "no repo mapping". In the common
|
|
10
|
+
# single-team setup, REPO_TEAM_ID is the same UUID as LINEAR_TEAM_ID.
|
|
7
11
|
REPO_URL=
|
|
8
12
|
REPO_DEFAULT_BRANCH=main
|
|
9
13
|
REPO_TEAM_ID=
|
|
@@ -16,6 +20,11 @@ DASHBOARD_USER=admin
|
|
|
16
20
|
DASHBOARD_PASSWORD=
|
|
17
21
|
|
|
18
22
|
# === Optional ===
|
|
23
|
+
# Override per-stage agent budget (maxTurns / maxInputTokens / model / tools).
|
|
24
|
+
# Useful when the test stage has to bootstrap test infra from scratch and
|
|
25
|
+
# burns through the default 25-turn cap. See urateam#38.
|
|
26
|
+
# URATEAM_AGENT_PROFILES='{"test":{"maxTurns":50,"maxInputTokens":80000}}'
|
|
27
|
+
|
|
19
28
|
# SLACK_WEBHOOK_URL=
|
|
20
29
|
# DISCORD_WEBHOOK_URL=
|
|
21
30
|
# GITHUB_WEBHOOK_SECRET=
|
|
@@ -9,7 +9,40 @@ to implement features, fix bugs, and create PRs automatically.
|
|
|
9
9
|
|
|
10
10
|
1. Fill in `.env` with your Linear API key, webhook secret, team ID, and repo URL
|
|
11
11
|
2. Install dependencies: `pnpm install`
|
|
12
|
-
3.
|
|
12
|
+
3. **Authenticate Claude** (OSS path only — see [Claude auth lifecycle](#claude-auth-lifecycle-oss-tier) below): `claude login`
|
|
13
|
+
4. Start the agent: `pnpm dev` (SQLite, local dev) or `pnpm start` (production)
|
|
14
|
+
|
|
15
|
+
## Claude auth lifecycle (OSS tier)
|
|
16
|
+
|
|
17
|
+
The free / OSS tier of urateam runs against the local `claude` CLI session,
|
|
18
|
+
**not** an Anthropic API key. That session expires periodically (typically
|
|
19
|
+
weekly) and **`ura dev` will refuse to start when the session is invalid** —
|
|
20
|
+
this prevents the failure mode where webhooks fail mid-pipeline and Linear
|
|
21
|
+
issues get marked as failed before you notice.
|
|
22
|
+
|
|
23
|
+
If you see this banner at startup (the exact wording varies slightly between
|
|
24
|
+
`pnpm dev` and `pnpm start`):
|
|
25
|
+
|
|
26
|
+
```
|
|
27
|
+
⚠ Claude session auth check failed at startup.
|
|
28
|
+
The local `claude` session is missing or expired.
|
|
29
|
+
Run `claude login` and restart `ura dev`. Without this fix,
|
|
30
|
+
webhooks will fail mid-pipeline and the agent will mark Linear issues
|
|
31
|
+
as failed — requiring manual recovery.
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
…run `claude login` (interactive — opens a browser), then restart `pnpm dev`
|
|
35
|
+
or `pnpm start`. Once running, urateam re-checks the session before each
|
|
36
|
+
agent invocation, so a session that expires mid-day is caught before it
|
|
37
|
+
mutates Linear state.
|
|
38
|
+
|
|
39
|
+
**Production / containerized:** the production banner shown by `pnpm start`
|
|
40
|
+
mentions the docker-compose form: `docker compose exec <service> claude login`.
|
|
41
|
+
Use that variant when re-authing inside a running container.
|
|
42
|
+
|
|
43
|
+
**Upgrading off this:** the Anthropic API tier (long-lived API key) doesn't
|
|
44
|
+
have session-lifetime semantics, so this whole concern goes away. See the
|
|
45
|
+
[urateam docs](https://github.com/JonB32/urateam) for upgrade paths.
|
|
13
46
|
|
|
14
47
|
## Expose the webhook
|
|
15
48
|
|