How to use AI Collaboration Platform
A walk through every screen in the order you will meet it, with real screenshots from the app. You do not need to read all of it: use the contents on the left and jump to what you need.
The screenshots in this manual use a sample project called billing-service for illustration. On your machine you will see your own project instead.
Sign in
Sign in with your company account to enter the app. If the company server is briefly unreachable, the screen tells you clearly and lets you retry or change the server address.
- Fill in "Email or username" and "Password", then click the sign-in button.
- Click the flag + EN switcher at the top-left anytime to change the display language.
- If it shows "Could not reach the company server. Contact your administrator.", click "Retry connection", or click "Server: <url>" to change the server address.
Welcome screen
This is the first screen after signing in, shown when no project is open yet. It prompts you to open a source folder to start working.
- Read the heading "Open a project folder to get started" - this is the action needed.
- Read the note "Everything runs 100% locally - client code never leaves the machine. Egress is always 0." for the security guarantee.
- Click the "Open folder..." button and pick a source folder on your machine.
Interface overview
Once a project is open, the screen splits into three columns: the file explorer on the left, the editor in the middle, and the AI chat panel on the right. The topbar shows which mode you are in and which model is answering.
- Click "Dev IDE" or "Comtor" in the mode switch to change what you are doing.
- Click "Select model..." to see which model is answering you.
- Check the green "Egress 0" pill in the topbar - it shows outbound traffic stays at 0.
- Click the tabs above the editor - Code, Test, Review, Insight, Scout, Tools, Terminal (Terminal sits at the far right) - to switch panels.
Choosing a model
Click "Select model..." in the topbar to choose which AI answers you: a model that runs on your own machine, or one provided through the company gateway. Dev IDE and Comtor each remember their own choice.
- Click "Select model..." in the topbar to open the model list.
- Pick a model under the "Company Local" or "Company Cloud" group - these are provided through the company gateway.
- Or choose the option for a model that runs on your own machine, no company gateway needed.
- Switch between "Dev IDE" and "Comtor" - each mode remembers its own model choice.
Open a file in Explorer
The Explorer mirrors your project folder exactly as it sits on disk; click a file to open it straight in the editor. Content is read directly from the folder, so what you see always matches what is on your machine.
- Click a file in the Explorer tree on the left.
- See the file content appear in the editor with syntax highlighting.
- Edit directly in the editor; every action reads and writes the exact file on disk.
Ask your AI teammate
Type a request in plain language, Vietnamese works too, into the chat box to ask your AI teammate to do a specific job. Not sure where to start? Pick one of the ready made suggestions instead.
- Click the box with the placeholder 'Describe what to do... (Enter to send)' and type your request, for example: 'Write tests for the pricing function'.
- Or pick one item from the 'SUGGESTIONS (SMALL TASKS, VERIFY FAST)' list above the input box.
- Click 'Send' (or press Enter) to submit; when you need a new line, follow the hint 'Enter to send - Shift+Enter for newline'.
Review changes before anything is saved
Whenever your AI teammate needs to read or change a file, the action shows up as its own tool card, such as 'read_file' or 'write_file', so you can see exactly what it is doing. For a write, the card shows the lines added and removed, and you decide by clicking 'Approve' or 'Reject'.
- Watch for a 'read_file' card when your AI teammate opens a file to read it; nothing on disk changes at this point.
- When your AI teammate proposes a file change, a 'write_file' card appears showing the lines added and the lines removed so you can preview it.
- Read the proposed change, then click the green 'Approve' button to write it to the real file, or the red 'Reject' button to turn it down.
- Remember: nothing is written to the file on your machine until you personally click 'Approve', you always stay the final decision maker.
Run tests in the Test tab
The 'Test' tab runs your project's own unit tests and reports a clear pass/fail result. You never need to leave the app or open a separate terminal just to run tests.
- Open the 'Test' tab in the center area of the Dev IDE.
- Run the project's test suite and wait for the result.
- Read the pass/fail result to see right away what is working and what needs fixing.
Check code against a checklist
The 'Review' tab checks your code against a standardized checklist and returns a bilingual result, Japanese and English, for every finding. It gives you an objective second look before handoff.
- Open the 'Review' tab and pick the scope of code to check.
- Run the review and let the standardized checklist score each finding.
- Read the Japanese and English result for each finding to understand the issue clearly.
Find issues in the Insight tab
The 'Insight' tab automatically finds security, robustness, performance, and maintainability issues in your code. Every finding comes with a severity level and a concrete suggested fix.
- Open the 'Insight' tab to scan the current code.
- Browse the list of findings sorted by severity across security, robustness, performance, and maintainability.
- Open a finding to read the concrete fix that Insight suggests.
Generate a project wiki with Scout
The 'Scout' tab reads through your project's code and generates an easy to follow wiki, so developers, PMs, and BAs can all understand what the project does without reading every line of code. It is especially handy for handoffs or onboarding someone new.
- Open the 'Scout' tab and pick the scope of code to document.
- Run Scout and wait for it to generate the wiki for each file.
- Read the wiki to understand the project from whichever angle you need, whether you are a developer, a PM, or a BA.
Run AI Factory tools in the Tools tab
The 'Tools' tab gathers six tools you can run right inside the app, so you never need to switch to another one: Estimate Review, Check Report, Detail Schedule Review, AI Cost Estimator, Office to Markdown and Technical Consultation. Results come back in place, ready to read or download.
- Open the 'Tools' tab and pick what you need from the list of six tools.
- Enter the input or attach the file the tool needs.
- Run it and view the result right inside the app.
Use the built-in terminal
The built-in terminal runs commands right inside the project folder you have open, so you never need a separate terminal window outside the app. Every command you type executes exactly at that project path on your machine.
- Open the 'Terminal' tab in the center area of the Dev IDE.
- Type commands as usual; they run right in the project folder you have open.
- See the command output right inside the app, no need to switch to another terminal window.
Translate documents
This is the main screen for translating documents between Japanese and Vietnamese right on your computer; before you can translate, pick a processing model in settings, or the translate button will show "Not ready". The screen also shows the line "Fully local translation - Egress 0", telling you the work happens on your own machine.
- Switch to "Comtor" in the topbar, then open the "Translate documents" tab.
- Choose the "Source language" (or leave it on Auto-detect) and the "Target language" for the document.
- Drag files into "Drag & drop files here" or click "Choose files" (.docx .xlsx .pptx .txt .csv .md are supported); optionally pick a "Glossary" and turn on "Keep formatting" to preserve layout.
- Click "Start translating"; the finished file is saved in the same folder with ".vi" added to the file name.
Bilingual review
The "Bilingual review" tab shows the original text and the translation side by side so you can check them sentence by sentence, paragraph by paragraph. Use this step before sending the translation to a client or partner.
- Switch to "Comtor", then open the "Bilingual review" tab.
- Compare the original text and the translation shown side by side, reading through sentence by sentence.
- Note any sentences that do not read well yet, and fix them before sending the translation to the client.
Glossary & TM
The "Glossary & TM" tab keeps everyone in the company using the same set of terms, instead of each person translating them differently. It also stores previously translated sentences so they can be reused, keeping new translations consistent with older ones.
- Open the "Glossary & TM" tab under "Comtor".
- Add or check company-specific terms (product names, department names, etc.) so the whole team translates them the same way.
- When you translate a similar document again later, the system will suggest sentences you already translated before (translation memory, or TM) so you can reuse them.
Conversation
The "Conversation" tab helps you go back and forth between Japanese and Vietnamese, for example during a chat or call with a Japanese partner. It also helps you write polite Japanese with correct honorific language (keigo) when the exchange needs to be formal.
- Open the "Conversation" tab under "Comtor".
- Type or paste the sentence you received or want to say, in Japanese or Vietnamese.
- When writing to a client or a senior contact on the Japanese side, ask for a polite version with correct honorific language (keigo).
Feedback
The "Feedback" tab helps you draft a reply to a client or Japanese partner in the tone you want (for example, a gentle apology, a firm reply, or a friendly one). You can still edit the draft before actually sending it.
- Open the "Feedback" tab under "Comtor".
- Describe the situation and the tone you want (for example, a gentle apology, a firm reply, or a friendly one).
- Read through and edit the draft before actually sending it.
Settings
Click the gear icon in the topbar to open Settings. Here you change the display language, switch between light and dark themes, and (on desktop) adjust model routing.
- Click the gear (Settings) icon in the topbar.
- Under "Language", click a flag to switch the interface between vi/en/ja.
- Under "Theme", click "Light" or "Dark" to change the appearance.
Light theme
You do not need to open Settings to change the look - there is a single button right on the topbar. Click it to switch between light and dark themes anytime.
- Find the sun/moon icon button in the topbar, next to the feedback and Settings icons.
- Click it - the tooltip reads "Switch to light theme" or "Switch to dark theme" depending on the current mode.