CGTerm

CGTerm is a minimal terminal-like interface written in Go & C. It provides a interactive command loop with a set of built-in commands for system interaction.

The project is somewhat lightweight and serves as a foundation for a terminal emulator, command handling, and modular Go & C packages.

Features

• Interactive prompt: Simple > interface.
• Built-in commands: common commands to help.
• Modular package structure: Own commands can be easily added. To do this read How to make custom commands
• Basic terminal control: Functions for clearing the screen and listing directories.

Requirements

• Golang
• 5mb+ storage

Building & Installing

Build from source

Building from source can be done with go

1. clone CGTerm repository

git clone https://github.com/MasterArd/CGTerm.git
cd CGTerm

2. Install

go build .

Install

Installation: Manually move the built binary named cgterm to the /bin directory.

sudo mv cgterm /usr/bin

Automatic make Install

1. clone CGTerm repository

git clone https://github.com/MasterArd/CGTerm.git
cd CGTerm

2. Use make install

make install

Run CGTerm

Once installed to the bin directory. Launch cgterm.

Binaries can be found at Releases

Available Commands

Standard commands

Command	Description
host	Prints the system hostname
clear	Clears the terminal screen
exit	Exits the program
whoami	Same as host
lsa	List all files and directories
lsd	List all directories but not files
lsf	List all files but not directories
lse	List all executable files and nothing else
help	Show help
batt	Show battery status in a live view
cd	Change directories
cg	execute CGTerm shell scripts
cgtermff	show fetch of CGTerm

External commands

Command	Details
fastfetch	May need fastfetch installed
sheh	Required sheh and needed CGTerm installed
hello	Print "Hello, World!";

• fastfetch

• sheh

Project Structure

/
├── main.go          # Entry point and command loop
├── Makefile         # Build and run automation
├── customConfig/    # Directory for custom (startup) configs
    └──startup.go    # [optional] Custom startup file
└── commands/
    ├── stdpkg.go    # Standard commands
    ├── registry.go  # Collecting commands.
    ├── cg.go        # Needed for CGTerm shell execution
    └── c/           # Standard commands written in C

Contributing

contribution can be done by forking this repository and making a pull request.

Note

Contribution might not always be accepted.

---

Issues:

• help not working and giving large errors
• clear displaying rogue [ (fixed)
• sheh blocking termination from CGTerm. (fixed)
• sudo infite password input spam when sudo is prompted. (fixed)
• text editors like nano, vi, vim, nvim currently dont work due to stdin (fixed)

dev notes:

this is an improvement over UAC. (old archive): https://msad.online/projects