Руководство пользователя Chatminal

Используйте Chatminal как рабочее пространство, к которому вы возвращаетесь, а не как одноразовый терминал.

Эта страница написана для пользователей, а не для контрибьюторов. Здесь объясняется, как установить Chatminal, как связаны sessions и profiles, как работают layouts и чего ожидать, когда вы возвращаетесь к работе позже.

Установка

Установите Chatminal

Chatminal — это desktop-терминал для тех, кто хочет держать shell-сессии организованными и легко возобновляемыми. Выберите способ установки, который соответствует вашей платформе и подходу к обновлениям.

  • Используйте install script, если хотите самый быстрый terminal-first путь на macOS или Linux.
  • Используйте Homebrew на macOS, если хотите устанавливать и обновлять через brew.
  • Используйте GitHub Release, если предпочитаете прямую загрузку архива приложения или работаете на Windows.
  • Готовые сборки сейчас доступны для macOS, Linux x86_64 и Windows x64.

bash

Установка через Bash

Устанавливает последнюю стабильную версию и остаётся самым быстрым путём из терминала.

curl -fsSL https://chatminal.com/install | bash

brew

Установка через Homebrew

Используйте на macOS, если хотите, чтобы Chatminal управлялся как обычный cask.

brew tap Khoa280703/chatminal https://github.com/Khoa280703/chatminal
brew install --cask chatminal

windows

Загрузка для Windows

Windows сейчас распространяется через zip-файл последнего GitHub Release.

start https://github.com/Khoa280703/chatminal/releases/latest

Первый запуск

Что происходит при первом запуске

Когда Chatminal открывается впервые, он запускает ваш shell по умолчанию и даёт чистое место для создания рабочих сессий вместо того, чтобы складывать всё в одну терминальную вкладку.

  • Начните с новой shell-сессии и проверьте своё рабочее окружение по умолчанию.
  • Создавайте отдельные сессии для отдельных задач или репозиториев.
  • Используйте profiles, чтобы группировать связанные сессии.

Sessions

Sessions и profiles

Sessions — базовая единица в Chatminal. Каждая session хранит собственный shell, рабочий каталог и состояние активности. Profiles помогают группировать sessions по проекту, команде или workflow.

  • Создавайте одну session на задачу, репозиторий или окружение.
  • Переключайтесь между profiles, когда хотите сменить контекст, не теряя текущие sessions.
  • Переименовывайте sessions, чтобы боковая панель честно отражала их назначение.
  • Используйте startup-команды для sessions, которые открываете часто.

Layouts

Разделения и layouts

Chatminal спроектирован для работы сразу с несколькими sessions. Layouts позволяют делить workspace, держать важные sessions на виду и позже возвращаться к знакомой раскладке.

  • Разделяйте workspace, когда вам нужно одновременно видеть логи, вывод shell и ещё одну задачу.
  • Используйте layouts, чтобы держать длительные процессы на виду, а не переключаться туда-сюда.
  • Сохранённые layouts упрощают повторное открытие той же формы workspace позже.

История

История и возобновление

Chatminal сохраняет состояние sessions, чтобы вы могли вернуться к работе без старта с пустого терминала каждый раз. Это включает историю sessions и структуру workspace.

  • История session может сохраняться, чтобы старый вывод оставался доступен при возвращении.
  • Повторное открытие приложения должно ощущаться как продолжение работы, а не как запуск с нуля.
  • Если нужен чистый старт, можно очистить историю и сбросить контекст session.

Запуск

Startup-команды

Если session всегда начинается одинаково, сохраните startup-команду. Это удобно для открытия проекта, подключения к инструменту или быстрого восстановления привычного shell-потока.

  • Используйте startup-команды для sessions, которые повторяются каждый день.
  • Держите их сфокусированными на быстром возврате в рабочее состояние.
  • Считайте их удобством, а не полноценным deployment script.

FAQ

Частые вопросы

Текущий путь продукта — desktop-first и session-focused. Если вы решаете, подходит ли Chatminal под ваш workflow, именно эти вопросы самые важные.

  • Поддерживает ли он несколько sessions? Да, это одна из ключевых частей продукта.
  • Можно ли организовать работу по profiles? Да, profiles — часть сохраняемой модели workspace.
  • Запоминает ли он layouts и history? Да, persistence встроен в runtime и store.
  • Эта страница для контрибьюторов? Нет. Она написана для конечных пользователей.