kylon-cli 0.3.10-next.713 → 0.4.0-next.714

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/README.md CHANGED
@@ -79,8 +79,8 @@ blocks scheduled tasks) the daemon runs in the foreground until `Ctrl+C`, and
79
79
  ### `kylon onboard`
80
80
 
81
81
  `kylon onboard` is the terminal-first way to start: it creates a **new**
82
- workspace from the Claude Code context already on this machine. Run it from
83
- your project directory, or install and onboard in one line:
82
+ workspace from the Claude Code or Codex context already on this machine. Run it
83
+ from your project directory, or install and onboard in one line:
84
84
 
85
85
  ```bash
86
86
  curl -fsSL https://api.kylon.io/install.sh | sh -s -- onboard
@@ -90,11 +90,21 @@ The installer hands `kylon onboard` the controlling terminal for its one local
90
90
  question; on a machine without one (CI, a headless box) it passes `--yes` and
91
91
  the browser confirmation is the only gate.
92
92
 
93
+ Which agent it builds from is decided first, and never by guessing twice:
94
+ `--provider claude-code|codex` decides outright; otherwise, when only one of
95
+ the two has anything on this machine, that one is used; when both do, you are
96
+ asked. A run that cannot ask — `--yes`, `--json`, or the hosted installer's
97
+ non-TTY pipe — uses Claude Code, which is what the command has always meant, and
98
+ says so when it passed over Codex.
99
+
93
100
  It detects, offline and read-only, the project (the nearest `.git` ancestor,
94
101
  named from its `origin` repository when available and otherwise from its
95
- directory), the `CLAUDE.md` instruction files (project, `.claude/`, and
96
- user-level), and direct child skill packages under these exact repository
97
- locations:
102
+ directory), the instruction files, and the skill packages each agent loads.
103
+
104
+ For **Claude Code** that is the `CLAUDE.md` instruction files (project,
105
+ `.claude/`, and user-level), the user's Claude Code skill directory, the
106
+ project's memory entries, and direct child skill packages under these exact
107
+ repository locations:
98
108
 
99
109
  - `.claude/skills`
100
110
  - `.agents/skills`
@@ -102,15 +112,42 @@ locations:
102
112
  - `agent_resources/skills`
103
113
  - `skills`
104
114
 
105
- The user's Claude Code skill directory and the project's Claude Code memory
106
- entries are also included. Each skill package must be a direct child directory
107
- with a top-level `SKILL.md`. Discovery checks only the listed roots; it does not
108
- recursively search the repository for directories named `skills`. Roots are
109
- processed in the listed order, duplicate package names keep the first match,
110
- and an unusually large root is skipped before any packages inside it are read.
111
-
112
- Env files, credential-shaped content, binaries, empty files, oversized
113
- files, and symlinks are never uploaded. Its terminal summary shows the semantic
115
+ For **Codex** it is `AGENTS.md`, walked the way Codex walks it:
116
+ `$CODEX_HOME/AGENTS.md` first, then one file in **every** directory from the
117
+ repository root down to the working directory, deepest last, because that is
118
+ the order Codex applies them in and the order the persona is joined in. Its
119
+ skills come from `.agents/skills` in every directory from the working directory
120
+ up to the repository root, plus `$CODEX_HOME/skills` and `$HOME/.agents/skills`;
121
+ the nearest directory wins a name contest, and Codex's own `.system` built-ins
122
+ are left alone. `AGENTS.override.md` is never uploaded, for the same reason
123
+ `CLAUDE.local.md` is not: Codex documents it as a temporary machine-local
124
+ override, removed to restore the shared guidance, so it is one machine's
125
+ private amendment rather than the instruction set a workspace should inherit.
126
+ When the instruction chain is longer than the five-file cap, the global layer,
127
+ the repository root, and the directories nearest the working directory are kept
128
+ and the dropped middle is reported. There is a length budget as well as a file
129
+ count: the agent's instructions are held to a character limit that the server
130
+ applies by trimming the *end* of the joined text, which for Codex is the most
131
+ specific layer. So when the combined files are too long, the broadest ones are
132
+ dropped here instead — and named — so the instructions closest to your working
133
+ directory are the ones that survive.
134
+
135
+ Each skill package must be a direct child directory with a top-level
136
+ `SKILL.md`. Discovery checks only the listed roots; it does not recursively
137
+ search the repository for directories named `skills`. Roots are processed in
138
+ the listed order, duplicate package names keep the first match, and an
139
+ unusually large root is skipped before any packages inside it are read.
140
+
141
+ Codex memory is **not** uploaded unless you pass `--include-memory`. Claude
142
+ Code keeps memory per project, so onboarding one project uploads only that
143
+ project's entries; Codex keeps a single store under `$CODEX_HOME/memories`
144
+ covering every repository the machine has worked on, and sending all of it to a
145
+ new workspace is a choice rather than a detail. With the flag, the entries and
146
+ the compact `memory_summary.md` are uploaded; the `MEMORY.md` routing index and
147
+ Codex's derived working state (`raw_memories.md`, `rollout_summaries/`) are not.
148
+
149
+ Env files, credential-shaped content, binaries, empty files, oversized files,
150
+ and symlinks are never uploaded. Its terminal summary shows the semantic
114
151
  project name and its source separately from the physical checkout root. It then
115
152
  asks once (Enter confirms) and opens your browser: you sign in or sign up,
116
153
  review the proposal, rename or untick anything, and press one button. The
@@ -145,9 +182,9 @@ also stops the run until it is repaired or discarded, and so does a damaged
145
182
  `computer-session.json`, which is read strictly at the one-connection check. One `kylon onboard` runs per computer at a time (a
146
183
  second concurrent run is refused up front; a run that was paused for minutes
147
184
  while another took its place stops rather than continuing), and a resumed run
148
- applies the same one-connection rule as a fresh one. `--json` never starts Claude Code's interactive sign-in; a
149
- signed-out Claude Code fails with the command to run, and stdout stays one JSON
150
- document. A workspace credential that cannot be saved locally is revoked
185
+ applies the same one-connection rule as a fresh one. `--json` never starts the
186
+ provider's interactive sign-in; a signed-out Claude Code or Codex fails with the
187
+ command to run, and stdout stays one JSON document. A workspace credential that cannot be saved locally is revoked
151
188
  server-side rather than left live.
152
189
 
153
190
  For agent-driven runs, `--yes` skips the local prompt and `--json` (which
@@ -1,5 +1,5 @@
1
1
  {
2
- "version": "0.3.10-next.713",
3
- "fingerprint": "1469f9c1bb3247af7869a7f171120f9388dcc3927cae5d03632498f5ce99927a",
4
- "source_commit": "135254dd93fa5305b6b6b42c3d4c4741e1a3a892"
2
+ "version": "0.4.0-next.714",
3
+ "fingerprint": "49f262687539d8324488ff754db6d893b6dcff0df84d5491f97ba4b88ab843e2",
4
+ "source_commit": "99b6d7826fe83cd409423ad77ac663cf444fdd70"
5
5
  }