From 4ca24db97d00bdf8ea1fff49f2c6545ff9d10514 Mon Sep 17 00:00:00 2001 From: Craig Jennings Date: Fri, 5 Jun 2026 00:20:03 -0500 Subject: docs: note that the default team is optional A first-time reader can't tell from the Configuration table whether pearl-default-team-id is required to start. It isn't. Unset, it only adds a team prompt to pearl-create-issue and pearl-list-issues-by-project, and nothing else depends on it. I added a line saying so, next to the variable. --- README.org | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.org b/README.org index 86ac7df..e0d302b 100644 --- a/README.org +++ b/README.org @@ -413,6 +413,8 @@ Most users only need an API key and an output path. The rest are knobs for teams | =pearl-compose-window-size= | Size of that side window (fraction or lines) | | =pearl-debug= | Log request/response details to =*Messages*= | +The team default is optional. Leave =pearl-default-team-id= unset and Pearl asks which team only when you run =pearl-create-issue= or =pearl-list-issues-by-project=. Nothing else needs it. Set it to skip that prompt. + If a fetch stops at the pagination cap, Pearl writes =#+LINEAR-TRUNCATED: yes= in the file header. Raise =pearl-max-issue-pages= if your result set is larger than the default 1000 issues. *** Which browser opens for Linear URLs -- cgit v1.2.3