@neuraparse/synaptik 0.1.0 → 0.1.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.
- package/README.md +85 -30
- package/dist/cli.js +18070 -8665
- package/package.json +3 -3
package/README.md
CHANGED
|
@@ -1,10 +1,20 @@
|
|
|
1
1
|
# Synaptik
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Synaptik is a multi-provider AI coding CLI built for real terminal workflows.
|
|
4
|
+
|
|
5
|
+
It is designed for code understanding, code changes, provider switching, and
|
|
6
|
+
tool-driven development inside an active project workspace.
|
|
7
|
+
|
|
8
|
+
## Availability
|
|
9
|
+
|
|
10
|
+
Synaptik is currently distributed as an npm package.
|
|
11
|
+
|
|
12
|
+
The package is published, but the source code is not currently released as a
|
|
13
|
+
public open-source repository.
|
|
4
14
|
|
|
5
15
|
## Install
|
|
6
16
|
|
|
7
|
-
|
|
17
|
+
Install Synaptik globally:
|
|
8
18
|
|
|
9
19
|
```bash
|
|
10
20
|
npm install -g @neuraparse/synaptik
|
|
@@ -12,41 +22,86 @@ npm install -g @neuraparse/synaptik
|
|
|
12
22
|
|
|
13
23
|
This installs the `synaptik` and `syn` commands globally.
|
|
14
24
|
|
|
15
|
-
|
|
25
|
+
If you install the package locally instead of globally, run it with:
|
|
26
|
+
|
|
27
|
+
```bash
|
|
28
|
+
npx @neuraparse/synaptik
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
## What Synaptik Does
|
|
32
|
+
|
|
33
|
+
- Works across multiple AI providers in one coding workflow
|
|
34
|
+
- Lets you move between Claude and OpenAI-backed routes instead of being locked
|
|
35
|
+
to one path
|
|
36
|
+
- Supports provider chains and fallbacks for continuity
|
|
37
|
+
- Understands project context before editing
|
|
38
|
+
- Uses search, read, edit, write, shell, LSP, and MCP-aware workflows
|
|
39
|
+
- Supports project and user skills through `SKILL.md`
|
|
40
|
+
- Focuses on minimal, reviewable file changes instead of noisy rewrites
|
|
41
|
+
|
|
42
|
+
## Provider Support
|
|
16
43
|
|
|
17
|
-
-
|
|
18
|
-
- `bun run dev`
|
|
19
|
-
- `bun run build`
|
|
20
|
-
- `bun test`
|
|
21
|
-
- `bun run src/index.tsx doctor`
|
|
22
|
-
- `bun run src/index.tsx auth status`
|
|
23
|
-
- `bun run src/index.tsx auth login claude-code`
|
|
24
|
-
- `bun run src/index.tsx auth login codex-cli`
|
|
25
|
-
- `synaptik`
|
|
26
|
-
- `syn`
|
|
44
|
+
Synaptik supports both account-backed and API-based provider modes.
|
|
27
45
|
|
|
28
|
-
|
|
46
|
+
- `claude-code`
|
|
47
|
+
Uses the official `claude` CLI for account-backed Claude workflows
|
|
48
|
+
- `codex-cli`
|
|
49
|
+
Uses the official `codex` CLI for account-backed OpenAI workflows
|
|
50
|
+
- `anthropic`
|
|
51
|
+
Uses a direct Anthropic API configuration
|
|
52
|
+
- `openai-compatible`
|
|
53
|
+
Uses OpenAI-style API endpoints and compatible deployments
|
|
29
54
|
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
- `prepublishOnly` runs typecheck, tests, and build before publish
|
|
33
|
-
- package payload is limited to `dist/` and `README.md`
|
|
55
|
+
You can keep a provider chain configured so work can continue through another
|
|
56
|
+
provider path when needed.
|
|
34
57
|
|
|
35
|
-
##
|
|
58
|
+
## Skills
|
|
36
59
|
|
|
37
|
-
|
|
60
|
+
Synaptik supports reusable skills for project-specific or user-specific
|
|
61
|
+
workflow guidance.
|
|
38
62
|
|
|
39
|
-
Project
|
|
63
|
+
- Project skills can live under `.synaptik/skills/**/SKILL.md`
|
|
64
|
+
- User skills can live under `~/.synaptik/skills/**/SKILL.md`
|
|
65
|
+
- Built-in workflow skills help with investigation, editing, and verification
|
|
66
|
+
- Matching skills are injected into the turn context when relevant
|
|
67
|
+
|
|
68
|
+
## Coding Workflow
|
|
69
|
+
|
|
70
|
+
Synaptik is built for code work, not just chat.
|
|
71
|
+
|
|
72
|
+
- Discover files across the workspace
|
|
73
|
+
- Search code with grep-style matching
|
|
74
|
+
- Read full files or targeted ranges
|
|
75
|
+
- Build context from the current workspace, file mentions, and active skills
|
|
76
|
+
- Apply minimal edits with explicit approval-aware write flow
|
|
77
|
+
- Use shell commands, LSP intelligence, and MCP integrations from the same
|
|
78
|
+
runtime
|
|
79
|
+
|
|
80
|
+
## Editing and Safety
|
|
81
|
+
|
|
82
|
+
- Workspace-aware context assembly
|
|
83
|
+
- Approval-aware editing flow
|
|
84
|
+
- Preview-driven file mutations
|
|
85
|
+
- Minimal edits instead of broad rewrites
|
|
86
|
+
- Provider and tool routing based on request type
|
|
87
|
+
|
|
88
|
+
## Basic Usage
|
|
89
|
+
|
|
90
|
+
```bash
|
|
91
|
+
synaptik
|
|
92
|
+
synaptik doctor
|
|
93
|
+
synaptik auth status
|
|
94
|
+
synaptik auth login claude-code
|
|
95
|
+
synaptik auth login codex-cli
|
|
96
|
+
synaptik run "inspect the current codebase and summarize the main architecture"
|
|
97
|
+
```
|
|
40
98
|
|
|
41
|
-
|
|
99
|
+
## Configuration
|
|
42
100
|
|
|
43
|
-
- `~/.synaptik
|
|
44
|
-
- `.synaptik
|
|
45
|
-
- `synaptik-mvp` and `synmvp` remain available as aliases
|
|
101
|
+
- Global config path: `~/.synaptik/config.json`
|
|
102
|
+
- Project config path: `.synaptik.json`
|
|
46
103
|
|
|
47
|
-
##
|
|
104
|
+
## Package
|
|
48
105
|
|
|
49
|
-
-
|
|
50
|
-
-
|
|
51
|
-
- `claude-code`: account-backed bridge via official `claude` CLI
|
|
52
|
-
- `codex-cli`: account-backed bridge via official `codex` CLI
|
|
106
|
+
- npm package: `@neuraparse/synaptik`
|
|
107
|
+
- global commands: `synaptik`, `syn`
|