@sunasteriskrnd/takumi 1.0.0-dev.3 → 1.0.0-dev.31

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.
Files changed (3) hide show
  1. package/README.md +31 -36
  2. package/dist/index.js +58378 -59747
  3. package/package.json +12 -4
package/README.md CHANGED
@@ -34,40 +34,37 @@ Verify: `tkm --version`
34
34
  ```bash
35
35
  tkm --help # All commands
36
36
  tkm auth login # One-time login (default install path)
37
- tkm new # Create new project (interactive)
38
- tkm new --kit engineer # Create with specific kit
39
- tkm init # Initialize/update in current project
37
+ tkm init # Initialize/update in current project (interactive)
38
+ tkm init --kit core # Initialize with a specific kit
40
39
  tkm init -g -y # Global install, non-interactive
41
40
  ```
42
41
 
43
- The default `tkm init` / `new` / `versions` flows download releases
44
- through the authenticated Takumi server (no `gh` CLI required). Run
45
- `tkm auth login` once before the first install. The legacy GitHub
46
- flow is still available via `--use-gh` for archived tags.
42
+ The default `tkm init` / `versions` flows download releases through the
43
+ authenticated Takumi server (no `gh` CLI required). Run `tkm auth login`
44
+ once before the first install. The legacy GitHub flow is still available
45
+ via `--use-gh` for archived tags.
47
46
 
48
- ### Create New Project
47
+ ### Initialize / Update Project
49
48
 
50
- ```bash
51
- tkm new # Interactive
52
- tkm new --dir my-project --kit engineer # With options
53
- tkm new --archive ~/kit.zip # Offline install
54
- tkm new --install-skills # Auto-install skill deps
55
- tkm new --prefix # /tkm: namespace for commands
56
- ```
57
-
58
- ### Initialize or Update
59
-
60
- Run from project root:
49
+ `tkm init` is the sole entry point — it creates a missing target
50
+ directory automatically and works equally for new projects and updates
51
+ of existing ones. Run from a project root (or with `--dir`):
61
52
 
62
53
  ```bash
63
- tkm init # Interactive
64
- tkm init -y # Non-interactive, latest version
65
- tkm init -g --kit engineer -y # Global install
66
- tkm init --fresh # Clean reinstall (destructive)
67
- tkm init --archive ~/kit.zip # Offline install
68
- tkm init --local # From local monorepo (development)
54
+ tkm init # Interactive (claude-code default)
55
+ tkm init -y # Non-interactive, latest version
56
+ tkm init --dir my-project --kit core # Create new project at ./my-project
57
+ tkm init -g --kit core -y # Global install
58
+ tkm init --fresh # Clean reinstall (destructive)
59
+ tkm init --install-skills # Auto-install skill deps
60
+ tkm init --archive ~/kit.zip # Offline install
61
+ tkm init --local # From local monorepo (development)
62
+ tkm init -a codex # Install only codex agents/commands/skills
63
+ tkm init -a claude-code codex # Install both (sequential)
69
64
  ```
70
65
 
66
+ `--sync` is currently claude-code-only; combining `--sync` with any other agent is rejected with a clear error.
67
+
71
68
  ### Update CLI
72
69
 
73
70
  ```bash
@@ -84,30 +81,28 @@ tkm doctor --fix # Auto-fix issues
84
81
  tkm doctor --report # Shareable diagnostic report
85
82
  ```
86
83
 
87
- ### Skills & Agents
84
+ ### Install to Other Coding Agents
88
85
 
89
86
  ```bash
90
- tkm skills --help # Skill management
91
- tkm agents --help # Agent management
92
- tkm commands --help # Command discovery
87
+ tkm init -a codex --kit core # Install for Codex
88
+ tkm init -a claude-code -a codex # Install for multiple agents
93
89
  ```
94
90
 
95
91
  ### Other Commands
96
92
 
97
93
  ```bash
98
94
  tkm versions # List available versions
99
- tkm migrate # Run migration pipeline
100
95
  tkm uninstall # Remove Takumi
101
96
  tkm config get defaults.kit # Read config
102
- tkm config set defaults.kit engineer # Write config
97
+ tkm config set defaults.kit core # Write config
103
98
  ```
104
99
 
105
100
  ### Debugging
106
101
 
107
102
  ```bash
108
- tkm new --verbose # Verbose logging
109
- tkm new --verbose --log-file debug.log # Save to file
110
- TAKUMI_VERBOSE=1 tkm new # Via env var
103
+ tkm init --verbose # Verbose logging
104
+ tkm init --verbose --log-file debug.log # Save to file
105
+ TAKUMI_VERBOSE=1 tkm init # Via env var
111
106
  ```
112
107
 
113
108
  ## Authentication
@@ -126,7 +121,7 @@ Global config stored in `~/.claude/.takumi.json`; project config at `<project>/.
126
121
 
127
122
  ```json
128
123
  {
129
- "defaults": { "kit": "engineer", "dir": "." }
124
+ "defaults": { "kit": "core", "dir": "." }
130
125
  }
131
126
  ```
132
127
 
@@ -138,7 +133,7 @@ Never overwritten during updates: `.env*`, `*.key`, `*.pem`, `node_modules/**`,
138
133
 
139
134
  ```bash
140
135
  bun install # Install deps
141
- bun run dev new --kit engineer # Run locally
136
+ bun run dev init --kit core # Run locally
142
137
  bun test # Run tests (3600+ tests)
143
138
  bun run lint:fix # Auto-fix lint
144
139
  bun run typecheck # Type check