@ajaykumarnpm/talea 0.5.0 → 0.6.0

package/CHANGELOG.md

@@ -4,6 +4,11 @@ All notable changes to this project are recorded here. The format follows
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and the versions follow
 [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.6.0] - 2026-09-22
+
+### Breaking
+- `talea pick <repo>` keeps one repo; `talea update` upgrades the CLI
+
 ## [0.5.0] - 2026-09-22
 
 ### Added

package/README.md

@@ -66,6 +66,7 @@ talea sync                   # clone the new, fast-forward the rest
 talea status                 # branch, clean/dirty, ahead/behind, in one table
 talea add some-repo          # keep one more on this machine, and clone it now
 talea select                 # reopen the checklist and change the whole list
+talea pick some-repo          # keep that one — an unknown name opens the checklist
 cd $(talea where eklavya)
 ```
 
@@ -167,7 +168,7 @@ Treat the id like a bookmark you would not paste into a public channel.
 | `talea clone` | clone only — never fetches or merges |
 | `talea adopt` | move checkouts you already have into place |
 | `talea status` | branch, clean/dirty, ahead/behind |
-| `talea select` | reopen the checklist — what this machine keeps |
+| `talea select` | reopen the checklist — `talea pick <repo>` for one |
 | `talea add` / `talea rm` | change that one repo at a time |
 | `talea where <repo>` | print a repo's path, for `cd $( )` |
 | `talea list` | the catalogue |
@@ -176,7 +177,7 @@ Treat the id like a bookmark you would not paste into a public channel.
 | `talea manifest push/pull` | move the catalogue between machines |
 | `talea skill` | install the skill that lets your coding agent drive talea |
 | `talea doctor` | check this machine can do the work |
-| `talea upgrade` | update the CLI itself |
+| `talea upgrade` | update the CLI itself (also `talea update`) |
 
 Every one of them takes `-g <group>` and `-r <repo>` to narrow the run, and
 `--help` for its own examples.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ajaykumarnpm/talea",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "One folder structure for every machine. Clone, adopt and sync your GitHub repos from a manifest you own.",
   "type": "module",
   "bin": {

package/skills/talea/SKILL.md

@@ -117,11 +117,17 @@ and nothing in talea will do it for them.
 talea add some-repo     # keep one more here, and clone it now
 talea rm some-repo      # stop keeping it — the checkout stays exactly where it is
 talea select            # reopen the whole checklist, interactively
+talea pick some-repo    # = add when the name is exact; otherwise the checklist
 ```
 
 `talea select` needs a terminal. In a non-interactive session it prints a
 summary instead of hanging, so prefer `add` and `rm` when acting on the
 developer's behalf and leave `select` as something to suggest they run.
+`pick <name>` falls back to that same checklist on a typo, so an agent uses
+`add`, which fails loudly instead.
+
+`talea update` reinstalls the CLI (it is `upgrade`), not `sync`. Never run it
+to refresh repos.
 
 `rm` does **not** delete the checkout. Say that plainly when you run it, or it
 reads like data loss.

package/src/cli.js

@@ -52,7 +52,6 @@ const ALIASES = {
   setup: 'init',
   bootstrap: 'init',
   pull: 'sync',
-  update: 'sync',
   refresh: 'discover',
   pick: 'select',
   choose: 'select',
@@ -63,6 +62,7 @@ const ALIASES = {
   run: 'exec',
   skills: 'skill',
   remove: 'rm',
+  update: 'upgrade',
   'self-update': 'upgrade',
 };
 
@@ -110,7 +110,7 @@ ${c.bold('Commands')}
   ${c.cyan('clone')}      clone only — never fetches or merges
   ${c.cyan('adopt')}      move repos you already have into the right place
   ${c.cyan('status')}     one table: branch, clean/dirty, ahead/behind
-  ${c.cyan('select')}     reopen the checklist — what this machine keeps
+  ${c.cyan('select')}     reopen the checklist — or ${c.dim('talea pick <repo>')} for one
   ${c.cyan('add')}        keep another repo on this machine (${c.dim('rm')} to drop one)
   ${c.cyan('where')}      print a repo's path — ${c.dim('cd $(talea where eklavya)')}
   ${c.cyan('list')}       show the catalogue

package/src/commands/add.js

@@ -34,12 +34,17 @@ Options
   -j, --jobs <n>        parallel clones
 `;
 
-/** Resolve `name` or `owner/name` against the catalogue, or exit saying why. */
-export function resolve(manifest, name) {
+/** Every catalogue entry `name` or `owner/name` could mean, ignoring case. */
+export function lookup(manifest, name) {
   const wanted = String(name).toLowerCase();
-  const matches = manifest.repos.filter(
+  return manifest.repos.filter(
     (r) => r.name.toLowerCase() === wanted || `${r.owner}/${r.name}`.toLowerCase() === wanted,
   );
+}
+
+/** Resolve `name` or `owner/name` against the catalogue, or exit saying why. */
+export function resolve(manifest, name) {
+  const matches = lookup(manifest, name);
 
   if (!matches.length) {
     fail(`No repo called "${name}" in the catalogue.`);

package/src/commands/select.js

@@ -9,9 +9,10 @@
 // because `clone` and `sync` ask the same question, and the cloning is
 // `clone.run`, re-entered after the new selection is on disk.
 
-import { c, fail, heading, ok, plain, skip } from '../log.js';
+import { c, fail, heading, ok, plain, skip, warn } from '../log.js';
 import { chooseRepos } from '../select.js';
 import { machineRepos, requireCatalogue, requireWorkspace } from '../workspace.js';
+import * as add from './add.js';
 import * as clone from './clone.js';
 
 export const help = `
@@ -19,6 +20,8 @@ ${c.bold('talea select')} — change what this machine keeps
 
   ${c.dim('talea select')}              reopen the checklist, then clone what is newly ticked
   ${c.dim('talea select --no-clone')}   change the list only, fill it in later
+  ${c.dim('talea pick PiDom')}          keep that one repo and clone it — or, if no repo
+                            has that name, open the checklist instead
 
 The checklist opens with the current selection ticked. Space toggles, Enter
 saves, Esc cancels and changes nothing. Everything in the catalogue is listed,
@@ -29,7 +32,10 @@ It writes ${c.dim('.talea.json')}, which never leaves this machine, so no other
 selection changes. Unticking a repo takes it off the list and leaves the
 checkout exactly where it is; deleting it is your call.
 
-For one repo, ${c.dim('talea add <repo>')} and ${c.dim('talea rm <repo>')} skip the checklist.
+A name that matches exactly one repo (case does not matter, ${c.dim('owner/name')} works)
+is ${c.dim('talea add <repo>')}. A name that matches none, or two owners' repos, opens the
+checklist, because a typo should land you in the list rather than nowhere.
+${c.dim('talea rm <repo>')} takes one off.
 
 Options
       --no-clone        save the selection, clone nothing
@@ -37,6 +43,11 @@ Options
   -j, --jobs <n>        parallel clones
 `;
 
+/** The names that do not pin down exactly one repo — empty means every one does. */
+export function unresolved(manifest, names) {
+  return names.filter((n) => add.lookup(manifest, n).length !== 1);
+}
+
 /** What changed, as two lists of names. Pure, so it can be tested. */
 export function changes(before, after) {
   const had = new Set(before);
@@ -47,7 +58,7 @@ export function changes(before, after) {
   };
 }
 
-export async function run(opts) {
+export async function run(opts, positionals = []) {
   const { root, manifest, state } = await requireWorkspace();
   requireCatalogue(manifest);
 
@@ -60,6 +71,12 @@ export async function run(opts) {
     process.exit(1);
   }
 
+  if (positionals.length) {
+    const missing = unresolved(manifest, positionals);
+    if (!missing.length) return add.run({ ...opts, removing: false }, positionals);
+    warn(`No single repo called ${missing.map((n) => `"${n}"`).join(', ')} — opening the checklist.`);
+  }
+
   const before = machineRepos(manifest, state).map((r) => r.name);
   const { repos } = await chooseRepos({ manifest, root, state, opts: { ...opts, pick: true } });
   const after = repos.map((r) => r.name);

package/src/commands/upgrade.js

@@ -6,6 +6,7 @@ export const help = `
 ${c.bold('talea upgrade')} — update the CLI itself
 
   ${c.dim('talea upgrade')}                    reinstall from npm at the latest version
+  ${c.dim('talea update')}                     the same thing
   ${c.dim('talea upgrade --check')}            only report whether one is available
   ${c.dim('talea upgrade --on')}               turn the daily update notice on
   ${c.dim('talea upgrade --off')}              turn the daily update notice off