@sunasteriskrnd/takumi 1.0.0-dev.9 → 1.0.0-preview.2

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 +22 -31
  2. package/dist/index.js +81990 -70593
  3. package/package.json +17 -9
package/README.md CHANGED
@@ -34,36 +34,29 @@ 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
54
  tkm init # Interactive (claude-code default)
64
55
  tkm init -y # Non-interactive, latest version
65
- tkm init -g --kit engineer -y # Global install
56
+ tkm init --dir my-project --kit core # Create new project at ./my-project
57
+ tkm init -g --kit core -y # Global install
66
58
  tkm init --fresh # Clean reinstall (destructive)
59
+ tkm init --install-skills # Auto-install skill deps
67
60
  tkm init --archive ~/kit.zip # Offline install
68
61
  tkm init --local # From local monorepo (development)
69
62
  tkm init -a codex # Install only codex agents/commands/skills
@@ -88,30 +81,28 @@ tkm doctor --fix # Auto-fix issues
88
81
  tkm doctor --report # Shareable diagnostic report
89
82
  ```
90
83
 
91
- ### Skills & Agents
84
+ ### Install to Other Coding Agents
92
85
 
93
86
  ```bash
94
- tkm skills --help # Skill management
95
- tkm agents --help # Agent management
96
- 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
97
89
  ```
98
90
 
99
91
  ### Other Commands
100
92
 
101
93
  ```bash
102
94
  tkm versions # List available versions
103
- tkm migrate # Run migration pipeline
104
95
  tkm uninstall # Remove Takumi
105
96
  tkm config get defaults.kit # Read config
106
- tkm config set defaults.kit engineer # Write config
97
+ tkm config set defaults.kit core # Write config
107
98
  ```
108
99
 
109
100
  ### Debugging
110
101
 
111
102
  ```bash
112
- tkm new --verbose # Verbose logging
113
- tkm new --verbose --log-file debug.log # Save to file
114
- 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
115
106
  ```
116
107
 
117
108
  ## Authentication
@@ -130,7 +121,7 @@ Global config stored in `~/.claude/.takumi.json`; project config at `<project>/.
130
121
 
131
122
  ```json
132
123
  {
133
- "defaults": { "kit": "engineer", "dir": "." }
124
+ "defaults": { "kit": "core", "dir": "." }
134
125
  }
135
126
  ```
136
127
 
@@ -142,7 +133,7 @@ Never overwritten during updates: `.env*`, `*.key`, `*.pem`, `node_modules/**`,
142
133
 
143
134
  ```bash
144
135
  bun install # Install deps
145
- bun run dev new --kit engineer # Run locally
136
+ bun run dev init --kit core # Run locally
146
137
  bun test # Run tests (3600+ tests)
147
138
  bun run lint:fix # Auto-fix lint
148
139
  bun run typecheck # Type check