klaudiak 2.1.90 → 2.1.91
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/.env.example +1 -1
- package/Makefile +22 -22
- package/README.md +17 -4
- package/cli.js +16 -16
- package/klaudiak.js +20 -5
- package/package.json +1 -1
package/.env.example
CHANGED
package/Makefile
CHANGED
|
@@ -7,18 +7,18 @@ export
|
|
|
7
7
|
endif
|
|
8
8
|
|
|
9
9
|
# Override at runtime if needed, e.g.:
|
|
10
|
-
# make run
|
|
11
|
-
|
|
10
|
+
# make run KLAUDIAK="node cli.js"
|
|
11
|
+
KLAUDIAK ?= npx klaudiak
|
|
12
12
|
|
|
13
13
|
# Proxy defaults
|
|
14
14
|
PROXY_PORT ?= 9090
|
|
15
15
|
OPENROUTER_MODEL ?= deepseek
|
|
16
16
|
OLLAMA_MODEL ?= llama3.1
|
|
17
|
-
|
|
17
|
+
KLAUDIAK_MODEL ?= $(OPENROUTER_MODEL)
|
|
18
18
|
|
|
19
19
|
.PHONY: help
|
|
20
20
|
help:
|
|
21
|
-
@echo "claude-code-
|
|
21
|
+
@echo "claude-code-klaudiak power-user recipes"
|
|
22
22
|
@echo ""
|
|
23
23
|
@echo "Setup & discovery"
|
|
24
24
|
@echo " make env-init - Create .env from .env.example (first-time setup)"
|
|
@@ -65,60 +65,60 @@ env-init:
|
|
|
65
65
|
|
|
66
66
|
.PHONY: help-cli
|
|
67
67
|
help-cli:
|
|
68
|
-
@$(
|
|
68
|
+
@$(KLAUDIAK) --help
|
|
69
69
|
|
|
70
70
|
.PHONY: auth-status
|
|
71
71
|
auth-status:
|
|
72
|
-
@$(
|
|
72
|
+
@$(KLAUDIAK) auth status --text
|
|
73
73
|
|
|
74
74
|
.PHONY: run
|
|
75
75
|
run:
|
|
76
|
-
@$(
|
|
76
|
+
@$(KLAUDIAK)
|
|
77
77
|
|
|
78
78
|
.PHONY: bare
|
|
79
79
|
bare:
|
|
80
|
-
@$(
|
|
80
|
+
@$(KLAUDIAK) --bare
|
|
81
81
|
|
|
82
82
|
.PHONY: print
|
|
83
83
|
print:
|
|
84
84
|
@if [[ -z "$(PROMPT)" ]]; then echo "Usage: make print PROMPT='explain this repo'"; exit 1; fi
|
|
85
|
-
@$(
|
|
85
|
+
@$(KLAUDIAK) --print "$(PROMPT)"
|
|
86
86
|
|
|
87
87
|
.PHONY: print-json
|
|
88
88
|
print-json:
|
|
89
89
|
@if [[ -z "$(PROMPT)" ]]; then echo "Usage: make print-json PROMPT='summarize changes'"; exit 1; fi
|
|
90
|
-
@$(
|
|
90
|
+
@$(KLAUDIAK) --print --output-format json "$(PROMPT)"
|
|
91
91
|
|
|
92
92
|
.PHONY: safe-print
|
|
93
93
|
safe-print:
|
|
94
94
|
@if [[ -z "$(PROMPT)" ]]; then echo "Usage: make safe-print PROMPT='write tests'"; exit 1; fi
|
|
95
|
-
@$(
|
|
95
|
+
@$(KLAUDIAK) --print --max-turns 4 --max-budget-usd 2 "$(PROMPT)"
|
|
96
96
|
|
|
97
97
|
.PHONY: continue
|
|
98
98
|
continue:
|
|
99
|
-
@$(
|
|
99
|
+
@$(KLAUDIAK) --continue
|
|
100
100
|
|
|
101
101
|
.PHONY: resume
|
|
102
102
|
resume:
|
|
103
103
|
@if [[ -z "$(SESSION)" ]]; then echo "Usage: make resume SESSION='<session-id-or-search>'"; exit 1; fi
|
|
104
|
-
@$(
|
|
104
|
+
@$(KLAUDIAK) --resume "$(SESSION)"
|
|
105
105
|
|
|
106
106
|
.PHONY: debug-run
|
|
107
107
|
debug-run:
|
|
108
|
-
@$(
|
|
108
|
+
@$(KLAUDIAK) --debug
|
|
109
109
|
|
|
110
110
|
.PHONY: worktree
|
|
111
111
|
worktree:
|
|
112
|
-
@$(
|
|
112
|
+
@$(KLAUDIAK) --worktree "$(NAME)"
|
|
113
113
|
|
|
114
114
|
.PHONY: proxy-openrouter
|
|
115
115
|
proxy-openrouter:
|
|
116
116
|
@if [[ -z "$$OPENROUTER_API_KEY" ]]; then echo "Set OPENROUTER_API_KEY first"; exit 1; fi
|
|
117
|
-
@OPENROUTER_API_KEY="$$OPENROUTER_API_KEY" npx
|
|
117
|
+
@OPENROUTER_API_KEY="$$OPENROUTER_API_KEY" npx klaudiak proxy "$(OPENROUTER_MODEL)"
|
|
118
118
|
|
|
119
119
|
.PHONY: run-openrouter
|
|
120
120
|
run-openrouter:
|
|
121
|
-
@ANTHROPIC_BASE_URL="http://localhost:$(PROXY_PORT)"
|
|
121
|
+
@ANTHROPIC_BASE_URL="http://localhost:$(PROXY_PORT)" KLAUDIAK_MODEL="$(KLAUDIAK_MODEL)" $(KLAUDIAK)
|
|
122
122
|
|
|
123
123
|
.PHONY: proxy-ollama
|
|
124
124
|
proxy-ollama:
|
|
@@ -126,23 +126,23 @@ proxy-ollama:
|
|
|
126
126
|
|
|
127
127
|
.PHONY: run-ollama
|
|
128
128
|
run-ollama:
|
|
129
|
-
@ANTHROPIC_BASE_URL="http://localhost:$(PROXY_PORT)"
|
|
129
|
+
@ANTHROPIC_BASE_URL="http://localhost:$(PROXY_PORT)" KLAUDIAK_MODEL="$(OLLAMA_MODEL)" $(KLAUDIAK)
|
|
130
130
|
|
|
131
131
|
.PHONY: doctor
|
|
132
132
|
doctor:
|
|
133
|
-
@$(
|
|
133
|
+
@$(KLAUDIAK) "/doctor"
|
|
134
134
|
|
|
135
135
|
.PHONY: init
|
|
136
136
|
init:
|
|
137
|
-
@$(
|
|
137
|
+
@$(KLAUDIAK) "/init"
|
|
138
138
|
|
|
139
139
|
.PHONY: mcp-serve
|
|
140
140
|
mcp-serve:
|
|
141
|
-
@$(
|
|
141
|
+
@$(KLAUDIAK) mcp serve
|
|
142
142
|
|
|
143
143
|
.PHONY: plugins
|
|
144
144
|
plugins:
|
|
145
|
-
@$(
|
|
145
|
+
@$(KLAUDIAK) plugin list --json
|
|
146
146
|
|
|
147
147
|
|
|
148
148
|
.PHONY: publish
|
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Klaudia Kode
|
|
2
2
|
|
|
3
|
-
Klaudia Kode is a
|
|
3
|
+
Klaudia Kode is a coding agent wrapper CLI that can run against many LLM providers through a local OpenRouter-compatible proxy.
|
|
4
4
|
|
|
5
5
|
## Quick Start
|
|
6
6
|
|
|
@@ -28,20 +28,29 @@ npx klaudiak
|
|
|
28
28
|
|
|
29
29
|
```bash
|
|
30
30
|
klaudiak
|
|
31
|
+
klaudiak [agentArgs...]
|
|
31
32
|
klaudiak --profile=<name>
|
|
33
|
+
klaudiak --defaults=<name>
|
|
32
34
|
klaudiak --port=<port>
|
|
35
|
+
klaudiak --port <port>
|
|
33
36
|
```
|
|
34
37
|
|
|
35
38
|
- `klaudiak` starts the coding agent.
|
|
39
|
+
- Any additional args are forwarded to `cli.js` (for example `-p "..."`).
|
|
36
40
|
- `--profile=<name>` loads settings from `~/.klaudiak` profile `<name>`.
|
|
41
|
+
- `--defaults=<name>` is an alias of `--profile=<name>`.
|
|
37
42
|
- `--port=<port>` sets `ANTHROPIC_BASE_URL=http://localhost:<port>` for this run when not already set.
|
|
43
|
+
- `--port <port>` is also supported.
|
|
38
44
|
|
|
39
45
|
When no profile flag is passed, Klaudiak always uses the `default` profile.
|
|
40
46
|
|
|
41
47
|
### Start proxy
|
|
42
48
|
|
|
43
49
|
```bash
|
|
50
|
+
klaudiak proxy
|
|
51
|
+
klaudiak proxy --profile=<name>
|
|
44
52
|
klaudiak proxy <model> key <apiKey> --port=<port>
|
|
53
|
+
klaudiak proxy <model> key <apiKey> --port <port>
|
|
45
54
|
```
|
|
46
55
|
|
|
47
56
|
Example:
|
|
@@ -53,10 +62,12 @@ klaudiak proxy openai/gpt-4o-mini key sk-or-v1-... --port=9090
|
|
|
53
62
|
- `<model>` is passed to `OPENROUTER_MODEL`.
|
|
54
63
|
- `<apiKey>` is passed to `OPENROUTER_API_KEY`.
|
|
55
64
|
- `--port=<port>` is passed to `PROXY_PORT`.
|
|
65
|
+
- `--port <port>` is also supported.
|
|
56
66
|
|
|
57
|
-
You can also run proxy from a profile
|
|
67
|
+
You can also run proxy from a profile with no model/key arguments when that profile includes `openrouterModel` and `openrouterApiKey`:
|
|
58
68
|
|
|
59
69
|
```bash
|
|
70
|
+
klaudiak proxy
|
|
60
71
|
klaudiak proxy --profile=<name>
|
|
61
72
|
```
|
|
62
73
|
|
|
@@ -68,11 +79,13 @@ Common commands:
|
|
|
68
79
|
|
|
69
80
|
```bash
|
|
70
81
|
klaudiak defaults list
|
|
82
|
+
klaudiak defaults show default
|
|
71
83
|
klaudiak defaults create gemini
|
|
72
84
|
klaudiak defaults set gemini type proxy
|
|
73
85
|
klaudiak defaults set gemini openrouterModel google/gemini-2.5-pro
|
|
74
86
|
klaudiak defaults set gemini openrouterApiKey sk-or-v1-...
|
|
75
|
-
klaudiak defaults
|
|
87
|
+
klaudiak defaults unset gemini anthropicApiKey
|
|
88
|
+
klaudiak defaults delete gemini
|
|
76
89
|
```
|
|
77
90
|
|
|
78
91
|
Supported fields:
|
|
@@ -118,7 +131,7 @@ Make sure:
|
|
|
118
131
|
- API key starts with an OpenRouter key format such as `sk-or-v1-...`
|
|
119
132
|
- Model string is valid for your provider account
|
|
120
133
|
|
|
121
|
-
## Migration from
|
|
134
|
+
## Migration from Klaudiak
|
|
122
135
|
|
|
123
136
|
- Package/command is now `klaudiak`
|
|
124
137
|
- Legacy aliases are removed
|