FlowTux documentation.
Setup in minutes.
Public docs for getting started, installing the FlowTux agent, running diagnostics, and configuring integrations.
What is FlowTux?
FlowTux is an AI-powered internal operations platform for growing teams. It gives every team in your company - IT, Dev, Design, Ops, Sales, HR, and more - one place to raise, track, and resolve internal issues.
The AI agent runs on your devices and fixes issues automatically. 73% of common issues are resolved without anyone being paged.
FlowTux has three parts:
1. The agent - a lightweight Python service that runs on each device. It collects device health data and executes approved fixes.
2. The platform - app.flowtux.com where your team manages tickets, runs diagnostics, and sees fleet health.
3. The AI layer - Gemini AI analyses device data, identifies issues, and maps them to specific fixes in plain English.
Quick start
Step 1
Create your account: Go to app.flowtux.com/signup, enter your work email and create a password, then you land on FlowDesk.
Step 2
Invite your team: Go to Team in the sidebar, click Invite Member, and assign Admin (full access) or Agent (tickets only).
Step 3
Install the agent: Open Settings -> Agent Download, choose your OS, run it, and your device appears in Network Map within 60 seconds.
Step 4
Run your first diagnostic: Go to AI Diagnostics, pick a device, click Run Diagnostic, then click Fix This on any issue to auto-resolve it.
Install the agent
The FlowTux agent is a lightweight background service (~15MB). It runs silently, uses minimal resources, and communicates with app.flowtux.com over HTTPS and WSS.
Requirements
Windows: Windows 10 or later, 64-bit
Mac: macOS 11 (Big Sur) or later
Linux: Ubuntu 20.04+, Debian 10+, or equivalent
Download
The agent download is available inside the app: Settings -> Agent Download -> select your OS.
Windows install
1. Download flowtux-agent.exe
2. Double-click to run
3. Enter your API key (Settings -> API Keys)
4. The agent installs as a Windows Service and starts automatically
Mac install
chmod +x flowtux-agent-mac
./flowtux-agent-mac --installEnter your API key when prompted. The agent registers as a launchd service.
Linux install
chmod +x flowtux-agent-linux
sudo ./flowtux-agent-linux --installEnter your API key when prompted. The agent registers as a systemd service.
Verify installation
After installation, go to Network Map in the app. Your device should appear within 60 seconds with status "Online".
Uninstall
Windows: Control Panel -> Programs -> FlowTux Agent -> Uninstall
Mac/Linux: Run flowtux-agent --uninstall in Terminal
What the agent collects
The agent never reads
Your first diagnostic
1. Go to AI Diagnostics in the left sidebar.
2. Select a device from the dropdown (only installed agents appear).
3. Choose scan depth: Quick (~5s), Standard (~8s), or Deep (~12s).
4. Click Run Diagnostic.
5. The AI returns a health score, a plain-English summary, issues by severity, what is working well, and estimated time to resolve.
Fixing an issue
1. Click Fix This on an issue with a command.
2. Review issue details and command in the modal.
3. Click Create Ticket + Fix.
4. A ticket is created first for audit trail.
5. Click Run Fix Now.
6. The agent executes the fix on-device and streams the result.
7. Ticket auto-resolves when the fix succeeds.
How AI resolution works
FlowTux uses Google Gemini AI to analyse device health data and produce structured reports.
The process
1. The agent collects health data every 5 minutes and sends it to the backend.
2. A diagnostic sends the latest snapshot to the AI service.
3. The AI analyses CPU, memory, disk, network, processes, updates, and antivirus health.
4. It returns health score, status, issues, actions, approved commands, and positives.
5. When you click Fix This, backend sends command over WebSocket for execution and live output.
What the AI can do
What the AI cannot do
Approved commands
The agent executes commands only from a strict whitelist. No arbitrary shell commands can be run.
| Command | What it does |
|---|---|
| flush_dns | Clears the DNS resolver cache |
| renew_ip | Releases and renews IP configuration |
| restart_network_adapter | Restarts a specific network adapter |
| ping_test | Tests connectivity to a host |
| get_network_info | Returns current network configuration |
| get_system_info | Returns OS and hardware details |
| get_running_processes | Returns top processes by CPU usage |
| get_installed_software | Returns list of installed applications |
| get_disk_usage | Returns disk usage per volume |
| get_cpu_usage | Returns current CPU metrics |
| get_memory_usage | Returns current memory metrics |
| get_update_status | Returns pending OS update count |
| get_antivirus_status | Returns antivirus and protection status |
| kill_process_by_pid | Terminates a specific process by PID |
| clear_temp_files | Clears system temporary files |
| get_event_logs | Returns recent Windows event log errors |
Commands outside this list are rejected by the agent.
The whitelist is hardcoded and cannot be modified remotely.
Ticket lifecycle
1. OPEN: Ticket is created manually, via AI Diagnostics, or automatically by agent events.
SLA starts: Critical 1h, High 4h, Medium 8h, Low 24h.
2. IN PROGRESS: An agent picks it up or AI starts a fix. Status updates automatically while commands run.
3. RESOLVED: The fix was applied. AI fixes auto-resolve with command output; manual fixes are logged.
4. CLOSED: Confirmed resolved with no further action needed.
Ticket sources
Manual: Created by a team member from Tickets.
AI Diagnostics: Created when Fix This is clicked.
Agent Auto: Created when the agent detects an issue (coming in a future release).
GitHub integration
Setup
1. Go to Settings -> Integrations.
2. Click Connect GitHub.
3. Authorize FlowTux in GitHub.
4. Choose a repository to sync.
What it does
Resolved FlowTux tickets can create GitHub issues automatically, and GitHub issue closure can sync linked ticket status back.
Use cases
Dev team: Bug reports raised in FlowTux appear in GitHub Issues.
IT team: Infrastructure fixes are logged in GitHub for audit trail.
Jira integration
Setup
1. Go to Settings -> Integrations.
2. Click Connect Jira.
3. Enter Jira workspace URL.
4. Authorize with Atlassian.
5. Select project to sync.
What it does
FlowTux tickets sync bidirectionally with Jira issues. Status changes in either tool update the other.
Use cases
Dev team: Sprint tickets tracked in both Jira and FlowTux.
IT team: IT issues visible to all teams via Jira.
Ops team: Cross-team requests managed in one place.
Slack (coming soon)
Slack integration is coming in Q2 2026.
Planned support: Notifications for critical AI resolutions, ticket creation from Slack messages, status updates to designated channels, and /flowtux commands.
Want early access? Email hello@flowtux.com and we will add you to the beta list.
Common questions
Q: Do I need to install the agent on every device?
Only devices you want to monitor. You can start with one and expand later. Tickets still work for all teams even when a device is not monitored.
Q: What operating systems does the agent support?
Windows 10+, macOS 11+, and major Linux distributions (Ubuntu 20.04+, Debian 10+). Mobile devices are not currently supported.
Q: Is my data safe?
The agent collects only system health signals and never reads files, emails, or documents. Traffic is encrypted over HTTPS and WSS, with hosting on Azure (India) and Google Cloud.
Q: Can the agent run commands without my permission?
No. A human must click Fix This and confirm execution. Every action is logged in the ticket audit trail.
Q: What happens if the agent goes offline?
Device status becomes Offline in Network Map. Queued commands run after reconnect and heartbeat monitoring alerts you when outages occur.
Q: Can I cancel anytime?
Yes. No contracts and no lock-in. Cancel from Settings, and data is retained for 30 days after cancellation.
Q: How is FlowTux different from Freshservice or Jira SM?
Three differences: flat pricing ($99/month regardless of team size), on-device AI fix execution, and setup in about 30 minutes instead of weeks.