빌드. 코드. 자동화.

CORE-TERMUX는 Termux를 완전한 개발 워크스테이션으로 변환하는 *모듈형 개발 환경 (modular dev environment)*입니다. 단일 코어 CLI를 통해 대화형 설치 마법사(interactive installation wizard)와 프로그래밍 언어, 데이터베이스 (databases), AI 에이전트 (AI agents), 코드 에디터 (code editors), 셸 설정 (shell configuration), 자동화 (automation) 등 전체 개발 스택을 아우르는 모듈형 시스템을 제공하며, 이 모든 것은 core install, core update, core uninstall과 같은 단순하고 일관된 명령어로 관리할 수 있습니다.

중요 사항

이 프로젝트는 오직 Android용 Termux를 위해 설계되었으며, 다른 플랫폼은 지원하지 않습니다.

curl -fsSL https://raw.githubusercontent.com/DevCoreXOfficial/core-termux/main/install.sh | bash

그 다음 실행:

core

명령	설명
core --version	현재 버전 표시
core setup	대화형 설치 마법사 (Interactive installation wizard)
core install	특정 모듈 설치
core show	도구 문서 표시
core update	모듈 또는 프레임워크 업데이트
core uninstall	설치된 모듈 제거
core open	브라우저에서 문서 열기
core list	모듈 내 사용 가능한 도구 목록 표시
core pg	PostgreSQL 데이터베이스 관리자
core init	기존 프로젝트 구성

이 모듈들은 대부분의 명령(core list, core install, core update, core uninstall, core show, core open)에서 사용할 수 있습니다:

모듈	설명
language	언어 패키지 (Node.js, Python, Perl, PHP, Rust, C/C++, Go)
db	데이터베이스 (PostgreSQL, MariaDB, SQLite, MongoDB)
ai	AI 도구 (Qwen Code, Gemini CLI, Mistral Vibe, OpenClaude, Claude Code, OpenClaw, Ollama, Codex, OpenCode, Engram, CodeGraph, Antigravity CLI, MiniMax CLI, Gentle AI, GGA)
editor	코드 에디터 구성 요소 (Neovim, NvChad)
tools	개발 도구 (gh, wget, curl, fzf, lsd, bat 등)
node	Node.js 글로벌 npm 패키지
shell	ZSH 플러그인
ui	Termux UI 구성 요소
automation	자동화 도구 (n8n)

설치된 Core-Termux 버전을 표시합니다.

core --version

출력:

Core-Termux v3.17.3

설치된 모든 도구에 대한 도움말 문서 (help documentation)를 표시합니다. 문서는 해당 모듈 디렉토리에 있는 도구의 README.md 파일에서 로드됩니다.

core show # 도움말 표시
core show <module> # 모듈 내의 모든 도구 목록 표시
core show <module> --<tool> # 특정 도구의 문서 표시

예시:

core show ai --opencode # OpenCode 문서 표시
core show db --postgresql # PostgreSQL 문서 표시
core show node --typescript # TypeScript 문서 표시

색상 출력: bat가 설치되어 있다면, 문서는 구문 강조 (syntax highlighting)와 함께 표시됩니다. 그렇지 않으면 일반 텍스트로 표시됩니다.

키보드 탐색이 가능한 대화형 마법사 (Interactive wizard)입니다.

core setup # 대화형 메뉴
core setup full # 자동 전체 설치
core setup base # 기본 패키지만 설치

대화형 메뉴 옵션:

Full installation (전체 설치)→ 모든 모듈 설치
Custom installation (사용자 정의 설치)→ ↑↓ 키로 특정 모듈 선택
Base installation (기본 설치)→ Termux 기본 패키지만 설치

모듈 내에서 사용 가능한 도구와 그 설치 상태를 나열합니다.

core list # 도움말 표시
core list <module> # 특정 모듈의 도구 목록 표시

Common Modules의 모든 모듈이 유효한 대상입니다.

개별 모듈 또는 모듈 내의 특정 도구를 설치합니다.

core install # 도움말 표시
core install <module> # 모듈 전체 설치
core install <module> --tool1 --tool2 # 특정 도구 설치
...

Common Modules의 모든 모듈이 유효한 대상입니다.

모듈 전체 설치:

core install ai # 모든 AI 도구 설치
core install db # 모든 데이터베이스 설치
core install tools # 모든 개발 도구 설치

특정 도구 설치:

core install ai --qwen-code --ollama # Qwen Code와 Ollama만 설치
core install db --postgresql --sqlite # PostgreSQL과 SQLite만 설치
core install tools --gh --fzf --jq # gh, fzf, jq만 설치
...

팁: core list <module>을 실행하세요.

사용 가능한 모든 도구와 해당 플래그 (flags)를 확인하려면 core list <module>을 실행하세요.

모듈 또는 전체 프레임워크 (framework)를 업데이트합니다.

core update # 도움말 표시
core update <target> # 특정 대상 업데이트
core update <target> --tool1 --tool2 # 특정 도구 업데이트
...

모든 공통 모듈 (Common Modules) 외에도, core update는 다음을 지원합니다:

대상 (Target)	설명 (Description)
all	프레임워크 (Framework) + 설치된 모든 패키지
core	Core-Termux 프레임워크만

모듈 전체 업데이트:

core update ai # 모든 AI 도구 업데이트
core update db # 모든 데이터베이스 업데이트

특정 도구 업데이트:

core update ai --qwen-code --ollama # Qwen Code와 Ollama만 업데이트
core update db --postgresql --sqlite # PostgreSQL과 SQLite만 업데이트
core update tools --gh --fzf --jq # gh, fzf, jq만 업데이트

설치된 모듈 또는 특정 도구를 제거합니다.

core uninstall # 도움말 표시
core uninstall <target> # 특정 대상 제거
core uninstall <target> --tool1 --tool2 # 특정 도구 제거
...

모든 공통 모듈 (Common Modules) 외에도, core uninstall은 다음을 지원합니다:

대상 (Target)	설명 (Description)
all	모든 것을 제거하고 Termux를 기본 상태로 복구

모듈 전체 제거:

core uninstall ai # 모든 AI 도구 제거
core uninstall db # 모든 데이터베이스 제거

특정 도구 제거:

core uninstall ai --qwen-code --ollama # Qwen Code와 Ollama만 제거
core uninstall db --postgresql --sqlite # PostgreSQL과 SQLite만 제거
core uninstall tools --gh --fzf # gh와 fzf만 제거

브라우저에서 공식 문서 (official documentation)를 엽니다.

core open # 도움말 표시
core open <target> # 브라우저에서 공식 문서 열기

모든 공통 모듈 (Common Modules)이 유효한 대상이며, 추가로 다음을 지원합니다:

대상 (Target)	설명 (Description)
core	Core-Termux 문서
devcorex	DevCoreX 공식 웹사이트

PostgreSQL 데이터베이스 관리자 (database manager).

core pg # 도움말 표시
core pg start # 서버 시작
core pg stop # 서버 중지
...

기능 (Features):

• 데이터 디렉토리 자동 감지 (Automatic data directory detection)
• 기존 설치본 지원 (Support for existing installations)
• 로그 기록 (Logs in)
  ~/.cache/core-termux/postgresql.log

사전 정의된 의존성(dependencies) 및 구조를 사용하여 기존 프로젝트를 구성합니다.

core init # 도움말 표시
core init <template> # 특정 템플릿으로 구성

사용 가능한 템플릿 (Available templates):

템플릿 (Template)	설명 (Description)
next	사전 구성된 의존성을 포함한 Next.js
react	현대적인 구조를 갖춘 React + Vite
nest	추가 설정이 포함된 NestJS
express	TypeScript + TypeORM을 사용하는 Express API

사용법 (Usage):

cd my-next-app && core init next
cd my-react-app && core init react
cd api && core init express
...

설치된 의존성 (Installed dependencies):

{
"dependencies": {
"axios": "latest",
...

설정 (Configuration):

.prettierrc

Tailwind CSS 플러그인 포함 - --webpack 플래그가 포함된 스크립트 - DevCoreX 랜딩 페이지 포함

• 구조 (Structure):
  components/, lib/, hooks/, types/, config/, store/

Next.js와 동일한 의존성 (Next.js 전용 설정 제외)

설정 (Configuration):

.prettierrc

Tailwind CSS 플러그인 포함 - 커스텀 Button 컴포넌트 - src/App.tsx에 DevCoreX 랜딩 페이지 포함

• 구조 (Structure):
  components/, lib/, hooks/, types/, config/, store/, pages/

의존성 (Dependencies):

express, pg, typeorm, reflect-metadata
jsonwebtoken, cookie-parser, morgan, cors
bcryptjs, helmet, cloudinary, multer
...

개발 의존성 (devDependencies):

typescript, ts-node-dev, tsconfig-paths, tsc-alias
@types/node, @types/multer, @types/morgan
@types/jsonwebtoken, @types/helmet
...

추가된 스크립트 (Scripts added):

{
"dev": "ts-node-dev --require tsconfig-paths/register --env-file=.env --respawn src/index.ts",
"build": "tsc && tsc-alias -p tsconfig.json",
...

생성된 구조 (Structure created):

src/
├── app.ts # Express 설정
├── index.ts # 엔트리 포인트 (Entry point)
...

구성된 파일 (Configured files):

tsconfig.json (경로(@/*) 포함)
.env.example
src/config/env.ts
src/database/data-source.ts (TypeORM)
src/app.ts

(CORS, helmet, rate-limit을 포함한 Express)src/index.ts

의존성 (Dependencies):

@nestjs/typeorm, typeorm, pg
@nestjs/jwt, @nestjs/passport
class-validator, class-transformer
...

language 모듈은 pkg를 통해 다음 프로그래밍 언어 및 런타임 (runtimes)을 설치합니다:

core install language

언어/런타임 (Language/Runtime)	패키지 (Package)	설명 (Description)
Node.js LTS	nodejs-lts	Node.js의 장기 지원 (Long-term support) 버전
Python	python	Python 3 인터프리터 (interpreter)
Perl	perl	Perl 스크립팅 언어 (scripting language)
PHP	php	PHP 인터프리터 (interpreter)
Rust	rust	Rust 컴파일러 (compiler) 및 Cargo
C/C++	clang	LLVM C/C++ 컴파일러 (compiler)
Go	golang	Go 프로그래밍 언어 (programming language)

tools 모듈은 pkg를 통해 다음 개발 유틸리티 (utilities)를 설치합니다:

core install tools

도구 (Tool)	패키지 (Package)	설명 (Description)
GitHub CLI	gh	공식 GitHub 커맨드라인 도구 (command-line tool)
Wget	wget	파일 다운로더 (File downloader)
Curl	curl	HTTP 클라이언트 (client) 및 전송 도구 (transfer tool)
LSD	lsd	아이콘과 색상이 포함된 현대적인 ls 대체 도구
Bat	bat	구문 강조 (syntax highlighting) 기능이 있는 현대적인 cat 대체 도구
Proot	proot	사용자 공간 (user-space)을 위한 Chroot 대안
Ncurses Utils	ncurses-utils	터미널 UI 조작 도구 (manipulation tools)
Tmate	tmate	즉각적인 터미널 공유 (terminal sharing)
Cloudflared	cloudflared	Cloudflare 터널 (Tunnel) 클라이언트
Translate Shell	translate-shell	커맨드라인 번역기 (translator)
html2text	html2text	HTML을 일반 텍스트 (plain text)로 변환하는 컨버터
jq	jq	경량 JSON 프로세서 (processor)
bc	bc	임의 정밀도 계산기 (Arbitrary precision calculator)
Tree	tree	재귀적 디렉토리 목록 (Recursive directory listing)
Fzf	fzf	커맨드라인 퍼지 파인더 (fuzzy finder)
ImageMagick	imagemagick	이미지 조작 스위트 (Image manipulation suite)
Shfmt	shfmt	셸 스크립트 포맷터 (Shell script formatter)
Make	make	빌드 자동화 도구 (Build automation tool)
Udocker	udocker	루트 (root) 권한 없이 Docker 컨테이너 실행

node 모듈은 다음 글로벌 npm 패키지들을 설치합니다:

core install node

패키지	명령어	설명
TypeScript	tsc	TypeScript 컴파일러 (compiler)
NestJS CLI	nest	NestJS 프레임워크 (framework) CLI
Prettier	prettier	코드 포매터 (Code formatter)
Live Server	live-server	라이브 리로드 (live reload) 기능이 있는 개발 서버 (Development server)
Localtunnel	lt	localhost를 인터넷에 노출 (Expose)
Vercel CLI	vercel	Vercel 배포 (deployment) CLI
Markserv	markserv	마크다운 (Markdown) 라이브 프리뷰 서버
PSQL Format	psqlformat	PostgreSQL 쿼리 포매터 (query formatter)
NPM Check Updates	ncu	오래된 의존성 (dependencies) 찾기
Ngrok	ngrok	localhost로의 보안 터널 (Secure tunnel)

editor 모듈은 NvChad을 기반으로 한 커스텀 설정이 적용된 Neovim을 설치합니다.

설치 (Installation):

core install editor

기능 (Features):

Neovim- 빠르고 확장 가능한 코드 에디터 (code editor)
NvChad- 현대적인 Neovim 설정 (configuration)
GitHub Copilot- AI 기반 코드 완성 (code completion)
CodeCompanion- 코드를 위한 AI 채팅 어시스턴트 (AI chat assistant)
사전 구성된 플러그인 (Preconfigured plugins)- LSP, 자동 완성 (autocomplete), 구문 강조 (syntax highlighting), 파일 탐색기 (file explorer) 등

포함된 언어 (Included languages):

• TypeScript/JavaScript
• Python
• PHP
• Perl
• Rust
• Lua
• 기타 등등...

에디터 설정, 플러그인 및 사용법에 대한 자세한 정보는 다음을 참조하세요:
→ 방문: https://github.com/DevCoreXOfficial/nvchad-termux

이 프레임워크는 색상, 아이콘 및 애니메이션이 포함된 전문적인 로깅 시스템 (logging system)을 포함합니다.

log_info "Info message"
log_success "Success message"
log_warn "Warning message"
...

명령어 실행 중 셸 출력 (shell output)을 숨깁니다:

LOG_FILE="$CORE_CACHE/install.log"
loading "Installing packages" _install_function
_install_function() {
...

separator # 단일 라인 (Single line)
separator_double # 이중 라인 (Double line)
separator_section "Title" # 라인이 포함된 중앙 정렬 제목 (Centered title with line)

box "Title"
box_large "Large title"
box_with_subtitle "Title" "Subtitle"

# 텍스트 입력 (Text input)
read_input "Name" VAR_NAME
# 확인 (y/n)
...

table_start "Col1" "Col2" "Col3"
table_row "value1" "value2" "value3"
table_end

core-termux/
├── LICENSE
├── README.md
...

export CORE_DEBUG=1 # 디버그 로그 활성화

디렉토리	설명
~/.local/share/core-termux-data	지속성 도구 데이터 (codegraph, engram, nvchad)
~/.cache/core-termux	로그 및 캐시 (cache)
~/.config/core-termux	사용자 설정 (configuration)

모든 프로세스는 다음 경로에 로그를 저장합니다:

~/.cache/core-termux/
├── install_language.log
├── install_db.log
...

프레임워크 (framework)는 자동으로 업데이트를 확인합니다:

빈도 (Frequency): 24시간마다 한 번
영향 (Impact): 없음 (백그라운드에서 실행)
알림 (Notification): 새 버전이 존재할 경우 core 실행 시 표시

$ core
── 업데이트 가능 (Update Available) ──────────────────
⚠ 새 버전 사용 가능: 3.17.4 (현재: 3.17.3)
...

업데이트하려면:

core update core

shell 모듈을 설치할 때: