askii-cli 0.3.0 → 0.3.1

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 +72 -0
  2. package/dist/index.js +352 -285
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -14,6 +14,78 @@ Or run without installing:
14
14
  npx askii-cli <command>
15
15
  ```
16
16
 
17
+ ## Interactive Mode
18
+
19
+ Run `askii` with no arguments to start an interactive REPL session:
20
+
21
+ ```bash
22
+ askii
23
+ askii --platform anthropic # start with a specific platform
24
+ ```
25
+
26
+ ```
27
+ ASKII ( •_•)>⌐■-■ (⌐■_■) — interactive mode
28
+
29
+ Platform : ollama (gemma4:e4b)
30
+ Workspace: /your/project
31
+ Wiki : off
32
+ Code wiki: off
33
+
34
+ Type a message to chat, /help for commands, /exit to quit.
35
+
36
+ > what does a closure do in JavaScript?
37
+
38
+ ASKII: A closure is a function that retains access to variables
39
+ from its enclosing scope even after that scope has finished...
40
+
41
+ > can you give me an example?
42
+
43
+ ASKII: Sure! Here's a classic counter example...
44
+
45
+ > /platform anthropic
46
+ Platform → anthropic (claude-sonnet-4-6)
47
+
48
+ > /do add a .gitignore for a Node.js project
49
+ [Round 1/5]
50
+ ...
51
+
52
+ > /exit
53
+ Bye! ( •_•)>⌐■-■ (⌐■_■)
54
+ ```
55
+
56
+ Bare text input maintains a **persistent chat history** across turns — follow-up questions remember the full conversation. Use `/clear` to start fresh.
57
+
58
+ ### REPL slash-commands
59
+
60
+ | Command | Description |
61
+ | --- | --- |
62
+ | `/help` | Show all available commands |
63
+ | `/ask <question>` | Explicit ask (same as bare text) |
64
+ | `/do <task> [flags]` | Run the Do agent (`--max-rounds N`, `--yes`) |
65
+ | `/edit --file <path> <instr>` | Edit a file in place |
66
+ | `/explain <text>` | Explain a line of code |
67
+ | `/wiki-reload` | Rebuild the docs wiki index |
68
+ | `/code-wiki-reload` | Rebuild the code wiki index |
69
+ | `/platform <name>` | Switch platform for the session (also updates default model) |
70
+ | `/model <name>` | Switch model for the session |
71
+ | `/config` | Show current session config (keys redacted) |
72
+ | `/clear` | Clear chat history and start a fresh conversation |
73
+ | `/exit`, `/quit` | Exit interactive mode |
74
+
75
+ Tab-complete any `/` command by pressing Tab. Up/down arrows cycle through input history.
76
+
77
+ **Config overrides** — bare `--` flags at the prompt update session config without restarting:
78
+
79
+ ```
80
+ > --platform openai --model gpt-4-turbo
81
+ > --max-rounds 10
82
+ > --mode helpful
83
+ ```
84
+
85
+ Ctrl+C during `/do` or `/control` cancels only that agent and returns to the `>` prompt. Ctrl+C at the idle prompt exits.
86
+
87
+ ---
88
+
17
89
  ## Commands
18
90
 
19
91
  ### `ask` — Ask a question about code