MXterm ghi những gì

MXterm Pro sửa vài file ngoài thư mục riêng của nó để coding agent trong pane gọi được server tích hợp, và để worktree và Finder action hoạt động. Không file nào chứa token thật: token của mỗi pane chỉ tới agent qua biến môi trường của chính pane đó. Trong Settings → Agents, công tắc Connect my agents to MXterm (bật theo mặc định) dừng mọi lần ghi vào file cấu hình của agent, và mỗi agent có nút Disconnect riêng. Cả hai không xoá gì ngoài mục mxterm của agent đó, và app không xoá gì khi bạn thoát hay gỡ cài đặt. Trang này liệt kê từng file để bạn tự kiểm tra hoặc gỡ.

File cấu hình của agent

Mỗi lần mở app, khi Connect my agents to MXterm đang bật, MXterm Pro thêm một mục mxterm vào cấu hình của Claude Code, Codex và omp (dù đã cài hay chưa), và của các agent khác bên dưới khi chúng đã được cài và kết nối. Mục này chỉ chứa chỗ giữ hoặc địa chỉ cục bộ của server tích hợp, không bao giờ chứa token.

File	Thêm gì
`~/.claude.json` (hoặc trong `$CLAUDE_CONFIG_DIR`)	`mcpServers.mxterm` với `${SWARMTERM_MCP_URL}` và `Bearer ${SWARMTERM_SESSION}`, cùng `crossSessionInbound: "accept"` khi chưa có khoá này; tạo file nếu chưa có
`~/.codex/config.toml` (hoặc trong `$CODEX_HOME`)	`[mcp_servers.mxterm]` chỉ có `url = "http://127.0.0.1:<port>/mcp"`; mỗi pane Codex tự truyền token riêng khi khởi động
`~/.omp/agent/mcp.json`	cùng mục `mxterm` như Claude Code, kèm thời gian chờ
Agent khác, chỉ khi đã cài	cùng một mục trong `~/.gemini/config/mcp_config.json` (Antigravity), `~/.config/opencode/opencode.json`, `~/.qwen/settings.json`, `~/.copilot/mcp-config.json`, và chỉ khi file đã có: `~/.openclaw/openclaw.json`, `~/.config/amp/settings.json`, `~/.config/crush/crush.json`, `~/.hermes/config.yaml`; `~/.cursor/mcp.json` chỉ sau khi bạn bấm Connect cho Cursor

Bản sao lưu: lần đầu sửa một file đã có, app giữ một bản riêng bên cạnh, tên <file>.mxterm-backup.
Disconnect (từng agent, trong Settings → Agents) gỡ mục mxterm của agent đó nếu vẫn là mục của MXterm, và không thêm lại nữa. Bản sao lưu và crossSessionInbound vẫn còn.
Plugin (thử nghiệm, chỉ cho người được mời, macOS, tắt theo mặc định): bật một plugin trong Settings → Plugins sẽ thêm mục riêng của nó, như mxterm-hub, vào các file trên; tắt là gỡ.
Các bản cũ thêm một dòng vào ~/.zshrc. Bản 1.1.87 xoá dòng đó một lần nếu còn, và không ghi gì vào ~/.zshrc.

Trong dự án của bạn

Đường dẫn	Khi nào	Ghi gì
`<project>/.gemini/settings.json`	khi một pane Gemini CLI mở ở đó, lúc Connect my agents to MXterm đang bật	mục `mxterm` với `${MXTERM_MCP_URL}` và `Bearer ${MXTERM_SESSION}`, Gemini CLI lấy giá trị từ môi trường của pane; không ghi token. Các bản trước 1.1.29 ghi chính token; pane Gemini kế tiếp sẽ thay nó.
`<project>/.gitignore`	cùng pane Gemini đó, và mỗi khi tạo worktree	`.gemini/settings.json` và `.worktrees/`; file chưa có thì được tạo. Dòng `.worktrees/` vẫn được thêm khi công tắc tắt.
`<project>/.worktrees/<branch>/`	khi chế độ cô lập worktree mở pane agent, hoặc agent xin worktree	một git worktree trên nhánh riêng
`<project>/.mxterm/`	khi agent mở pane kèm đề bài (thử nghiệm, chỉ cho người được mời, bật Let agents open panes; macOS và Linux)	`tasks/task-<id>.md`, chỉ bạn đọc được (quyền 0600), xoá khi pane đó đóng; thư mục có `.gitignore` riêng chứa `*`
`<project>/.gitkeep` và một commit	chỉ trong repo đã có nhưng chưa có commit nào, khi cần worktree	một "Initial commit" chỉ gồm `.gitkeep` để tạo được nhánh

Phần thêm cho Claude Code

Status line: ~/.claude/settings.json được thêm statusLine chạy MXterm Pro, bật theo mặc định. Tắt bằng Manage Claude Code's status line trong Settings → General; tắt là gỡ mục đó. Status line bạn tự đặt không bao giờ bị thay.
Skill điều phối: chỉ khi bạn bấm Install trong Settings → Agents (thử nghiệm, chỉ cho người được mời, bật Let agents open panes): sáu file và một manifest trong ~/.claude/skills/mxterm-orchestrator/ và ~/.agents/skills/mxterm-orchestrator/. Bản đã cài được làm mới khi mở app, không ghi đè file bạn đã sửa. Gỡ cũng ở đó.

Trên hệ thống

Finder action (macOS): ~/Library/Services/New MXterm Pro Tab Here.workflow và New MXterm Pro Window Here.workflow, kiểm tra mỗi lần mở app và chỉ ghi lại khi có thay đổi. Xoá khỏi thư mục đó để gỡ; lần mở app sau chúng sẽ có lại.
Mở cùng máy: chỉ khi bạn bật; macOS dùng mục đăng nhập của hệ thống, Windows dùng khoá Run, Linux dùng mục tự khởi động.
Keychain: mật khẩu và khoá SSH đã lưu, license, và một khoá cho sổ ghi của agent.
File tạm: ảnh dán trong $TMPDIR/mxterm-clipboard (xoá sau một ngày) và file mở qua SFTP trong $TMPDIR/mxterm-remote-files (dọn theo tuổi và dung lượng).

Trong môi trường của mỗi pane terminal

Mỗi pane terminal có MXTERM_SESSION và SWARMTERM_SESSION (token riêng của pane đó, ngẫu nhiên, chỉ nằm trong bộ nhớ) và MXTERM_MCP_URL, SWARMTERM_MCP_URL (địa chỉ cục bộ của server tích hợp). Token mất khi pane đóng. Nhờ vậy các mục ở trên hoạt động mà không chứa bí mật.

Trong thư mục riêng của app

Mọi thứ khác nằm trong thư mục dữ liệu riêng của MXterm Pro: phòng và log Control Room, cài đặt pane agent, trạng thái truy cập từ xa và chia sẻ, bộ nhớ đệm tài khoản và giới hạn, bộ nhớ đệm Token Meter, log chẩn đoán, các lựa chọn công tắc của bạn, hàng đợi và công tắc báo cáo sử dụng. Báo cáo sử dụng gửi gì có ở trang telemetry.