vaclavt/vterm
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Add GitHub-based install instructions and Package Control repository.json

Browse Source 
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
Vaclav Tvrdik
2026-09-30 11:06:35 +02:00
parent 27f1140737
commit e150591763
2 changed files with 54 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

41
README.md
View File

@@ -9,17 +9,42 @@ Requires Sublime Text 4 with the Python 3.8 plugin host (build 4149+, for
## Install ## Install
Symlink this folder into Sublime packages as `vterm`: ### With Package Control
```sh vterm is not on the default channel, so add its repository first. Open
ln -s /Users/vaclavt/devel/vt/vterm "$HOME/Library/Application Support/Sublime Text/Packages/vterm" **Preferences → Package Settings → Package Control → Settings** and put the URL
below in the `repositories` array of the right-hand (User) pane:
```json
{
"repositories": [
"https://raw.githubusercontent.com/vaclavt/vterm/main/repository.json"
]
}
``` ```
Dependencies (pyte, ptyprocess, wcwidth) are Package Control libraries declared Then run **Package Control: Install Package** from the Command Palette and pick
in `dependencies.json`. If they are not yet in `Lib/python38` (e.g. Terminus was **vterm**. Upgrades arrive through **Package Control: Upgrade Package** like any
never installed), run **Package Control: Satisfy Libraries** and restart Sublime. other package.
Package Control garbage-collects libraries no package requires, so if imports
ever fail after uninstalling another package, re-run *Satisfy Libraries*. ### From source
Clone the repository into the Sublime Text `Packages` directory as `vterm`:
```sh
git clone https://github.com/vaclavt/vterm.git \
"$HOME/Library/Application Support/Sublime Text/Packages/vterm"
```
Use one method or the other, not both: an unpacked `Packages/vterm` directory
overrides the `vterm.sublime-package` that Package Control installs.
Either way, dependencies (pyte, ptyprocess, wcwidth) are Package Control
libraries declared in `dependencies.json`. If they are not yet in
`Lib/python38` (e.g. Terminus was never installed), run **Package Control:
Satisfy Libraries** and restart Sublime. Package Control garbage-collects
libraries no package requires, so if imports ever fail after uninstalling
another package, re-run *Satisfy Libraries*.
## Use ## Use

21
repository.json Normal file
View File

@@ -0,0 +1,21 @@
{
"$schema": "sublime://packagecontrol.io/schemas/repository",
"schema_version": "4.0.0",
"packages": [
{
"name": "vterm",
"details": "https://github.com/vaclavt/vterm",
"description": "Minimalist terminal for Sublime Text 4, built to run TUI coding agents (pi, claude) in a tab",
"author": "vaclavt",
"labels": ["terminal", "shell", "pty"],
"releases": [
{
"sublime_text": ">=4149",
"platforms": ["osx"],
"python_versions": ["3.8"],
"tags": true
}
]
}
]
}