agentty 0.2.2 → 0.4.0
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/CHANGELOG.md +72 -0
- package/README.md +6 -105
- package/npm-shrinkwrap.json +2 -2
- package/package.json +5 -5
package/CHANGELOG.md
CHANGED
|
@@ -5,6 +5,78 @@ All notable changes to this project will be documented in this file.
|
|
|
5
5
|
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
|
|
6
6
|
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
7
7
|
|
|
8
|
+
## [v0.4.0] - 2026-02-24
|
|
9
|
+
|
|
10
|
+
### Added
|
|
11
|
+
|
|
12
|
+
- **Projects:** Add a projects tab with quick project switching.
|
|
13
|
+
- **Navigation:** Add backward tab navigation with `Shift+Tab`.
|
|
14
|
+
- **Docs:** Add the getting started overview guide.
|
|
15
|
+
|
|
16
|
+
### Changed
|
|
17
|
+
|
|
18
|
+
- **App:** Resolve main repository roots via git and exclude session worktrees.
|
|
19
|
+
- **UI:** Switch to `Sessions` after project selection and compact footer help actions.
|
|
20
|
+
- **Runtime:** Route app-server turns by provider, include root `AGENTS.md` instructions, and pass session folder/model in Codex payloads.
|
|
21
|
+
- **Docs:** Reorganize site sections, standardize skill headers, and migrate the docs site to compiled Sass styling.
|
|
22
|
+
- **Models:** Add support for the `gpt-5.3-codex-spark` model.
|
|
23
|
+
|
|
24
|
+
### Fixed
|
|
25
|
+
|
|
26
|
+
- **Database:** Fix SQLite migration `025` to avoid non-constant defaults.
|
|
27
|
+
- **Templates:** Fix malformed Tera block syntax in the base template.
|
|
28
|
+
- **Docs:** Remove duplicate front matter delimiters in overview content.
|
|
29
|
+
|
|
30
|
+
### Removed
|
|
31
|
+
|
|
32
|
+
- **Onboarding:** Remove the onboarding page from the list-mode flow.
|
|
33
|
+
- **Projects:** Remove project favorite controls from the project list.
|
|
34
|
+
|
|
35
|
+
### Contributors
|
|
36
|
+
|
|
37
|
+
- @andagaev
|
|
38
|
+
- @minev-dev
|
|
39
|
+
|
|
40
|
+
## [v0.3.0] - 2026-02-23
|
|
41
|
+
|
|
42
|
+
### Added
|
|
43
|
+
|
|
44
|
+
- **Docs:** Add copy button to code blocks.
|
|
45
|
+
- **Docs:** Add theme selector and favicon to site.
|
|
46
|
+
- **Docs:** Add contributing guide and templates.
|
|
47
|
+
- **Claude:** Enable Bash tool for Claude agent.
|
|
48
|
+
- **Output:** Stream Codex turn events to session output.
|
|
49
|
+
|
|
50
|
+
### Changed
|
|
51
|
+
|
|
52
|
+
- **Sync:** Fix pull rebase to target explicit upstream.
|
|
53
|
+
- **UI:** Cap chat input panel height and scroll prompt viewport.
|
|
54
|
+
- **Architecture:** Generalize app-server session handling.
|
|
55
|
+
- **Architecture:** Refactor site templates to use base layout.
|
|
56
|
+
- **UI:** Update docs sidebar styling.
|
|
57
|
+
- **Project:** Update repository URLs to new organization.
|
|
58
|
+
- **Architecture:** Move UI rendering into a dedicated render module.
|
|
59
|
+
- **Architecture:** Extract shared stdio JSON-RPC transport utilities.
|
|
60
|
+
- **UI:** Adopt Builder Lite pattern for UI components.
|
|
61
|
+
- **Project:** Update description to "Agentic Development Environment (ADE)".
|
|
62
|
+
- **Runtime:** Track active turn usage from completion and stream events.
|
|
63
|
+
- **UX:** Align view mode shortcuts with session state rules.
|
|
64
|
+
- **Runtime:** Require strict turn ID matching and make prompt char handling sync.
|
|
65
|
+
- **Output:** Filter synthetic completion status lines from chat output.
|
|
66
|
+
- **Deps:** Bump pulldown-cmark from 0.13.0 to 0.13.1.
|
|
67
|
+
|
|
68
|
+
### Removed
|
|
69
|
+
|
|
70
|
+
- **Command Palette:** Remove command palette and multi-project switching.
|
|
71
|
+
- **Docs:** Remove documentation sections and demo assets from README.
|
|
72
|
+
- **Slash Commands:** Remove `/clear` slash command and session history clearing logic.
|
|
73
|
+
|
|
74
|
+
### Contributors
|
|
75
|
+
|
|
76
|
+
- @andagaev
|
|
77
|
+
- @dependabot[bot]
|
|
78
|
+
- @minev-dev
|
|
79
|
+
|
|
8
80
|
## [v0.2.2] - 2026-02-22
|
|
9
81
|
|
|
10
82
|
### Added
|
package/README.md
CHANGED
|
@@ -2,16 +2,14 @@
|
|
|
2
2
|
|
|
3
3
|
|
|
4
4
|
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
5
|
+
Agentty is a terminal-first **Agentic Development Environment (ADE)**, designed for building software alongside AI agents. It is built with Rust and [Ratatui](https://ratatui.rs), with a deeply integrated, git-native workflow.
|
|
8
6
|
|
|
9
7
|
## Installation
|
|
10
8
|
|
|
11
9
|
### Shell
|
|
12
10
|
|
|
13
11
|
```sh
|
|
14
|
-
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/
|
|
12
|
+
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/agentty-xyz/agentty/releases/latest/download/agentty-installer.sh | sh
|
|
15
13
|
```
|
|
16
14
|
|
|
17
15
|
### Cargo
|
|
@@ -34,110 +32,13 @@ Run without installing:
|
|
|
34
32
|
npx agentty
|
|
35
33
|
```
|
|
36
34
|
|
|
37
|
-
##
|
|
38
|
-
|
|
39
|
-
- Rust nightly toolchain (configured via `rust-toolchain.toml`)
|
|
40
|
-
- Git (required for session worktree integration)
|
|
41
|
-
- One supported agent CLI installed: `gemini`, `claude`, or `codex`
|
|
42
|
-
|
|
43
|
-
## Session Agent, Model, and Permission Mode
|
|
44
|
-
|
|
45
|
-
Agent, model, and permission mode are configured per session.
|
|
46
|
-
|
|
47
|
-
- New sessions start with the configured `Default Model` value from `Settings`
|
|
48
|
-
plus the most recently used `permission_mode`.
|
|
49
|
-
- On a fresh setup (no previous session changes), defaults are `gemini` +
|
|
50
|
-
`gemini-3-flash-preview` + `auto_edit`.
|
|
51
|
-
- In prompt mode, type `/model` as the first input token to open the multistep picker:
|
|
52
|
-
- choose agent (`gemini`, `codex`, `claude`)
|
|
53
|
-
- choose model from that agent's curated model list
|
|
54
|
-
- In `Settings` -> `Default Model`, select `Last used model as default` to
|
|
55
|
-
persist model switches as the next-session default across app restarts.
|
|
56
|
-
- In prompt mode, press `Up` / `Down` to iterate previously sent messages for the active session and quickly resend/edit them.
|
|
57
|
-
- Permission modes:
|
|
58
|
-
- `auto_edit` (default): runs with standard edit permissions.
|
|
59
|
-
- After a plan response in chat view, an inline action bar appears:
|
|
60
|
-
- `Implement the plan`: switches that session to `auto_edit` and sends an implementation prompt.
|
|
61
|
-
- `Type feedback`: opens prompt input so you can send feedback without changing permission mode.
|
|
62
|
-
- Use `Up` / `Down` arrows to choose and `Enter` to confirm.
|
|
63
|
-
- The active mode is shown in the session chat title.
|
|
64
|
-
- Changes are persisted for that session and used as defaults for future sessions.
|
|
65
|
-
|
|
66
|
-
## Codex Sessions
|
|
67
|
-
|
|
68
|
-
- Codex sessions run through a persistent per-session `codex app-server` connection.
|
|
69
|
-
- Each Agentty session keeps one Codex thread open across replies.
|
|
70
|
-
- If the app-server connection fails, Agentty retries by restarting Codex app-server with a new thread.
|
|
71
|
-
- When a Codex thread is reset, Agentty replays the session transcript in the next turn prompt so implementation can continue with prior context.
|
|
72
|
-
- Codex session modes map to app-server permissions:
|
|
73
|
-
- `auto_edit`: `approvalPolicy=on-request` and workspace-write sandbox. Pre-action file/command requests are accepted.
|
|
74
|
-
|
|
75
|
-
## Features
|
|
76
|
-
|
|
77
|
-
### Git Worktree Integration
|
|
78
|
-
|
|
79
|
-
Agentty creates isolated worktrees for each session:
|
|
80
|
-
|
|
81
|
-
- **Isolated Branches:** Each session gets its own branch named `agentty/<hash>` based on your current branch
|
|
82
|
-
- **Separate Working Directory:** Sessions work in isolated directories under `~/.agentty/wt/`
|
|
83
|
-
- **Diff View:** Press `d` in the chat view to see real-time changes made by the agent
|
|
84
|
-
- **Rebase Action:** Press `r` in the chat view to rebase the session branch onto its base branch
|
|
85
|
-
- **Sync Action:** Press `s` in the session list to run session sync (`pull --rebase` + `push`) for review sessions
|
|
86
|
-
- Sync is available only when the active project branch is `main`
|
|
87
|
-
- Sync is blocked until `main` has no uncommitted changes
|
|
88
|
-
- **Automatic Cleanup:** Worktrees and branches are automatically removed when sessions are deleted
|
|
89
|
-
|
|
90
|
-
This allows agents to work on code changes without affecting your main working directory.
|
|
91
|
-
|
|
92
|
-
### Styled Session Output
|
|
93
|
-
|
|
94
|
-
- Agent responses in chat view now render a markdown subset with terminal styling.
|
|
95
|
-
- Supported formatting includes headings, bold/italic text, inline code, fenced code blocks, lists, blockquotes, and horizontal rules.
|
|
96
|
-
- User prompt lines (` › ...`) remain visually distinct in cyan bold styling.
|
|
97
|
-
|
|
98
|
-
### Stats Activity Heatmap
|
|
35
|
+
## Documentation
|
|
99
36
|
|
|
100
|
-
|
|
101
|
-
- Heatmap history is retained even after deleting old sessions.
|
|
102
|
-
- Heatmap intensity scales with daily session counts and now includes month labels for easier timeline scanning.
|
|
103
|
-
- A right-side summary panel highlights favorite model usage, the longest session duration, and per-model input/output token totals.
|
|
104
|
-
- The per-session token table and overall totals remain available below the heatmap.
|
|
37
|
+
Documentation for installation and workflows is available at [agentty.xyz/docs](https://agentty.xyz/docs/).
|
|
105
38
|
|
|
106
|
-
|
|
39
|
+
## Contributing
|
|
107
40
|
|
|
108
|
-
|
|
109
|
-
- If a newer version exists, an inline `vX.Y.Z version available update with npm i -g agentty@latest` notice is shown:
|
|
110
|
-
- in the top status bar next to the current version
|
|
111
|
-
- on the onboarding screen when there are no sessions
|
|
112
|
-
|
|
113
|
-
## Quickstart
|
|
114
|
-
|
|
115
|
-
```sh
|
|
116
|
-
git clone <repo-url>
|
|
117
|
-
cd agentty
|
|
118
|
-
cargo run # Builds and runs the 'agentty' binary
|
|
119
|
-
```
|
|
120
|
-
|
|
121
|
-
## Website
|
|
122
|
-
|
|
123
|
-
`agentty.xyz` is a Zola site stored in `docs/site/` and deployed through GitHub Pages.
|
|
124
|
-
|
|
125
|
-
```sh
|
|
126
|
-
# Preview locally
|
|
127
|
-
zola serve --root docs/site
|
|
128
|
-
|
|
129
|
-
# Build static output
|
|
130
|
-
zola build --root docs/site
|
|
131
|
-
```
|
|
132
|
-
|
|
133
|
-
## Development
|
|
134
|
-
|
|
135
|
-
```sh
|
|
136
|
-
cargo test
|
|
137
|
-
cargo clippy -- -D warnings
|
|
138
|
-
cargo fmt --all -- --check
|
|
139
|
-
cargo shear
|
|
140
|
-
```
|
|
41
|
+
See [CONTRIBUTING.md](CONTRIBUTING.md) for development checks and contribution guidance.
|
|
141
42
|
|
|
142
43
|
## License
|
|
143
44
|
|
package/npm-shrinkwrap.json
CHANGED
|
@@ -23,7 +23,7 @@
|
|
|
23
23
|
"hasInstallScript": true,
|
|
24
24
|
"license": "Apache-2.0",
|
|
25
25
|
"name": "agentty",
|
|
26
|
-
"version": "0.
|
|
26
|
+
"version": "0.4.0"
|
|
27
27
|
},
|
|
28
28
|
"node_modules/@isaacs/balanced-match": {
|
|
29
29
|
"engines": {
|
|
@@ -515,5 +515,5 @@
|
|
|
515
515
|
}
|
|
516
516
|
},
|
|
517
517
|
"requires": true,
|
|
518
|
-
"version": "0.
|
|
518
|
+
"version": "0.4.0"
|
|
519
519
|
}
|
package/package.json
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
{
|
|
2
|
-
"artifactDownloadUrl": "https://github.com/
|
|
2
|
+
"artifactDownloadUrl": "https://github.com/agentty-xyz/agentty/releases/download/v0.4.0",
|
|
3
3
|
"bin": {
|
|
4
4
|
"agentty": "run-agentty.js"
|
|
5
5
|
},
|
|
@@ -14,7 +14,7 @@
|
|
|
14
14
|
"detect-libc": "^2.1.2",
|
|
15
15
|
"rimraf": "^6.1.2"
|
|
16
16
|
},
|
|
17
|
-
"description": "
|
|
17
|
+
"description": "Agentic Development Environment (ADE) in your terminal",
|
|
18
18
|
"devDependencies": {
|
|
19
19
|
"prettier": "^3.7.4"
|
|
20
20
|
},
|
|
@@ -26,11 +26,11 @@
|
|
|
26
26
|
"major": 2,
|
|
27
27
|
"series": 35
|
|
28
28
|
},
|
|
29
|
-
"homepage": "https://github.com/
|
|
29
|
+
"homepage": "https://github.com/agentty-xyz/agentty",
|
|
30
30
|
"license": "Apache-2.0",
|
|
31
31
|
"name": "agentty",
|
|
32
32
|
"preferUnplugged": true,
|
|
33
|
-
"repository": "https://github.com/
|
|
33
|
+
"repository": "https://github.com/agentty-xyz/agentty",
|
|
34
34
|
"scripts": {
|
|
35
35
|
"fmt": "prettier --write **/*.js",
|
|
36
36
|
"fmt:check": "prettier --check **/*.js",
|
|
@@ -66,7 +66,7 @@
|
|
|
66
66
|
"zipExt": ".tar.xz"
|
|
67
67
|
}
|
|
68
68
|
},
|
|
69
|
-
"version": "0.
|
|
69
|
+
"version": "0.4.0",
|
|
70
70
|
"volta": {
|
|
71
71
|
"node": "18.14.1",
|
|
72
72
|
"npm": "9.5.0"
|