@giovannijecha/jecode 0.1.0-alpha.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.
- package/LICENSE +21 -0
- package/README.md +99 -0
- package/bin/jecode.exe +0 -0
- package/package.json +14 -0
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Giovanni Jecha
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
ADDED
|
@@ -0,0 +1,99 @@
|
|
|
1
|
+
# Jecode
|
|
2
|
+
|
|
3
|
+
An owned coding harness for your terminal, written in Rust.
|
|
4
|
+
|
|
5
|
+
Jecode streams model responses, reads local project files, proposes file changes,
|
|
6
|
+
and runs commands after approval. Conversations live in the terminal's natural
|
|
7
|
+
scrollback. Sessions, settings and account credentials belong to your user profile.
|
|
8
|
+
|
|
9
|
+
The application uses the Rust standard library and original code, with no external
|
|
10
|
+
crates, vendored libraries or runtime helpers for networking and presentation.
|
|
11
|
+
One controller owns the conversation and orders tool effects.
|
|
12
|
+
|
|
13
|
+
## Try it
|
|
14
|
+
|
|
15
|
+
Jecode is an **alpha** for Windows and Linux.
|
|
16
|
+
|
|
17
|
+
Windows x64, using npm:
|
|
18
|
+
|
|
19
|
+
```text
|
|
20
|
+
npm install -g @giovannijecha/jecode@next
|
|
21
|
+
jecode
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
The npm package contains the native executable. It has no install scripts or
|
|
25
|
+
package dependencies; Node is only needed to use npm. For Linux x64, download
|
|
26
|
+
the native archive from [releases](https://github.com/giovannijecha/jecode/releases),
|
|
27
|
+
extract it and run `./jecode` in your project directory. macOS is not supported yet.
|
|
28
|
+
|
|
29
|
+
Or build from source with Rust 1.95.0 and a native linker:
|
|
30
|
+
|
|
31
|
+
```text
|
|
32
|
+
cargo build --locked --offline --release --bin jecode
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
Windows PowerShell, from the repository:
|
|
36
|
+
|
|
37
|
+
```powershell
|
|
38
|
+
.\target\release\jecode.exe
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
Linux:
|
|
42
|
+
|
|
43
|
+
```sh
|
|
44
|
+
./target/release/jecode
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
Follow the device sign-in instructions on first use. Subsequent runs reuse the
|
|
48
|
+
saved account and refresh access when needed. GPT-5.6 Luna with medium effort is
|
|
49
|
+
the default; `--model gpt-5.6-terra` selects Terra for that run.
|
|
50
|
+
`jecode` uses your current directory; `--workspace PATH` selects another directory.
|
|
51
|
+
Use `jecode chat` for a conversation without file or command tools.
|
|
52
|
+
The workspace is the starting directory for relative paths. The default `local`
|
|
53
|
+
profile also accepts paths outside it; changes and commands still require approval.
|
|
54
|
+
Use `--access workspace` to restrict file tools to the selected directory.
|
|
55
|
+
|
|
56
|
+
```text
|
|
57
|
+
jecode resume
|
|
58
|
+
jecode sessions
|
|
59
|
+
jecode logout
|
|
60
|
+
jecode --demo
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
`--demo` is an offline interface preview. Normal conversations connect to OpenAI
|
|
64
|
+
Account; Cargo's `--offline` flag only controls build dependency resolution.
|
|
65
|
+
|
|
66
|
+
## Working with Jecode
|
|
67
|
+
|
|
68
|
+
- Enter sends a message; during a response it queues guidance for the next model step.
|
|
69
|
+
- Esc interrupts work. Ctrl+Q exits and joins active work before closing.
|
|
70
|
+
- File changes show a diff. Commands show their shell, directory and timeout.
|
|
71
|
+
- `/context` shows request size and available provider token counts.
|
|
72
|
+
- `/compact` summarizes earlier context while retaining the full saved history.
|
|
73
|
+
- Type `/` for a command menu; arrows select, Enter opens and Tab completes.
|
|
74
|
+
- `/new`, `/resume`, `/model` and `/settings` manage conversations and preferences.
|
|
75
|
+
- `NO_COLOR` and reduced motion are supported.
|
|
76
|
+
|
|
77
|
+
See [usage and configuration](docs/USAGE.md), [tools](docs/TOOLS.md),
|
|
78
|
+
[architecture](docs/ARCHITECTURE.md), and [platform support](docs/COMPATIBILITY.md).
|
|
79
|
+
|
|
80
|
+
Commands run with your user permissions: approval is not an operating-system
|
|
81
|
+
sandbox. Selected file contents and command output may be sent to the model.
|
|
82
|
+
Credentials are ordinary private JSON files; see [security](SECURITY.md) and the
|
|
83
|
+
[TLS profile](docs/TLS.md) for the exact boundaries and limitations.
|
|
84
|
+
|
|
85
|
+
## Build quality
|
|
86
|
+
|
|
87
|
+
```text
|
|
88
|
+
cargo run --locked --offline --bin jecode-check -- check
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
This checks the complete dependency graph, source package inventory, formatting,
|
|
92
|
+
Clippy and offline tests.
|
|
93
|
+
Tests and CI are part of the public source. See [contributing](CONTRIBUTING.md)
|
|
94
|
+
and [releasing](docs/RELEASING.md).
|
|
95
|
+
|
|
96
|
+
Jecode aims to reduce redundant work while preserving correctness. Comparative
|
|
97
|
+
performance claims require representative, reproducible measurements.
|
|
98
|
+
|
|
99
|
+
MIT licensed. Copyright 2026 Giovanni Jecha.
|
package/bin/jecode.exe
ADDED
|
Binary file
|
package/package.json
ADDED
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@giovannijecha/jecode",
|
|
3
|
+
"version": "0.1.0-alpha.1",
|
|
4
|
+
"description": "An owned terminal coding harness in Rust (Windows x64 alpha)",
|
|
5
|
+
"license": "MIT",
|
|
6
|
+
"repository": {"type": "git", "url": "git+https://github.com/giovannijecha/jecode.git"},
|
|
7
|
+
"homepage": "https://github.com/giovannijecha/jecode#readme",
|
|
8
|
+
"bugs": {"url": "https://github.com/giovannijecha/jecode/issues"},
|
|
9
|
+
"os": ["win32"],
|
|
10
|
+
"cpu": ["x64"],
|
|
11
|
+
"bin": {"jecode": "bin/jecode.exe"},
|
|
12
|
+
"files": ["bin/jecode.exe", "README.md", "LICENSE"],
|
|
13
|
+
"publishConfig": {"access": "public", "tag": "next"}
|
|
14
|
+
}
|