Cấu Hình Project

Thư mục .1devtool/ trong repo của bạn mang theo terminals, startup commands, và tasks — để đồng đội clone repo là có ngay setup của bạn.

Phần lớn những gì khiến một project trở nên dễ chịu để làm việc — bạn mở những terminal nào, mỗi terminal chạy gì khi khởi động, agent nào ngồi ở đâu — vốn là kiến thức chỉ nằm trong đầu một người. 1DevTool có thể đưa nó vào repository thay vì vậy.

Thư mục `.1devtool/`

Cấu hình project là một thư mục nằm ở gốc repository của bạn:

.1devtool/
  tasks/          # one markdown file per task
  ...             # project setup files

Đây chỉ là văn bản thuần túy, nên nó diff, review, và di chuyển cùng branch như bất kỳ file nào khác. Commit nó và đồng đội clone repo sẽ có ngay setup của bạn; thêm vào .gitignore thì nó vẫn chỉ là của riêng bạn.

Chỉnh sửa

Mở editor cấu hình từ context menu của project trong sidebar. Nó chỉnh sửa trực tiếp các file, nên bất cứ điều gì bạn làm được ở đây, bạn cũng có thể tự làm bằng tay trong một editor khác.

Editing the project configuration folder

Lệnh khởi động

Mỗi terminal có thể mang theo một lệnh khởi động chạy ngay khi nó mở lên — npm run dev, docker compose up, một SSH tunnel, hay một source .venv/bin/activate.

Chuỗi nhiều lệnh cũng được hỗ trợ và được biên dịch thành một dòng shell duy nhất, đó chính là điều giúp chúng hoạt động ổn định trên Windows ConPTY. Trên Windows, các lệnh WSL được bọc lại dưới dạng wsl -- bash -lc.

Tasks di chuyển cùng branch

Tasks là các file markdown nằm dưới .1devtool/tasks/. Một feature branch mang theo task riêng của nó, một pull request cho thấy những task mà nó thêm vào, và git log cho bạn biết khi nào một task thay đổi. Xem Tasks.

Chia sẻ hay giữ riêng cho mình

Sử dụng một cấu hình đã được chia sẻ là miễn phí. Việc tạo và export cấu hình là tính năng Pro — chủ đích là để một team có thể trao setup của mình cho bất kỳ ai, kể cả những người đang dùng gói Free.

Những gì không nên đưa vào đây

Secrets. Hãy dùng Environment Variables Manager cho các giá trị, và giữ .env ngoài repository như thường lệ. Cấu hình project mô tả hình dạng — những terminal nào, những lệnh nào — chứ không phải thông tin xác thực.