https://github.com/suningrass/chasm

personal tool for assembling character ----char assemble ---- chasm
https://github.com/suningrass/chasm

assembly character cli tui

Last synced: about 1 month ago
JSON representation

personal tool for assembling character ----char assemble ---- chasm

• Host: GitHub
• URL: https://github.com/suningrass/chasm
• Owner: suningrass
• Created: 2025-09-01T07:27:10.000Z (10 months ago)
• Default Branch: main
• Last Pushed: 2025-09-14T10:58:21.000Z (10 months ago)
• Last Synced: 2025-10-05T20:52:26.162Z (9 months ago)
• Topics: assembly, character, cli, tui
• Language: Go
• Homepage:
• Size: 46.9 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.MD

Awesome Lists containing this project

README

          
# chasm — Character Assembly CLI  

> my personal, interactive command-line string / command composer.

Written in pure Go and delivered as a single binary that works out-of-the-box on **macOS** and **Windows**.  

Core mission: **assemble the most complex commands with the fewest keystrokes**.

[中文](README_CN.MD)

---

## ✨ Key Features

1. **Smart Auto-Completion**  

   Logic lives in `components/insidewords.go`; swap in an external `insidewords.toml` for **hot-reload without recompiling**.

2. **Built-in File Navigator**  

   Mini file browser with fuzzy search, multi-select, and `Tab` path-completion.

3. **Macro Command Vault**  

   Store once, reuse forever—macros are fully customizable.

4. **Pipeline Friendly**  

   Pipe straight to any shell: `chasm ... | sh`.

5. **Clipboard Auto-Copy**  

   Generated string is **instantly copied** to the system clipboard—`Ctrl+V` to paste & run.

6. **Zero-Dependency & Cross-Platform**  

   Single static binary built with Go 1.20+. Runs on macOS & Windows with no extras.

---

## 🚀 Installation

```bash

# Run source directly

go run main.go

# Build locally

go build -o chasm

# Install globally

go install

🎮 Interactive Mode Cheat-Sheet

| Key          | Mode         | Purpose                              |

| ------------ | ------------ | ------------------------------------ |

| `Tab` / `↑↓` | **CMDMOD**   | Default command input + completion   |

| `Ctrl+P`     | **BATMODE**  | Quick-insert / search macro commands |

| `Ctrl+O`     | **FILEMODE** | Pick files/folders (multi-select)    |

| `Ctrl+N`     | **ARGMODE**  | Select from upstream pipe list       |

Universal Shortcuts

Shift+←/→: switch categories (BATMODE / FILEMODE)

Enter: confirm & return to CMDMOD

Real-time fuzzy search box always available

📌 Typical Workflow

Goal: run seed download 

Launch chasm → CMDMOD.

Type seed → Tab to accept completion.

At  hit Ctrl+O → FILEMODE to choose file.

Tab to select → Enter inject path → Enter exit.

Final command is now in clipboard; paste with Ctrl+V or run directly:

chasm seed download /path/to/file | sh

⚙️ Customization

| Method       | File                        | Notes                               |

| ------------ | --------------------------- | ----------------------------------- |

| **Embedded** | `components/insidewords.go` | edit source & rebuild               |

| **External** | `insidewords.toml`          | drop-in replacement, zero recompile |

🛠️ Tech Stack

Language: Go 1.20+

Deps: stdlib only + tiny clipboard helper

Terminal: ANSI & Windows Console compatible