Frequently asked questions
24 questions people actually ask, with the short answer and a link to the page that has the long one.
Privacy
Does my code or my prompts leave my machine?
No. A report carries derived state only: an issue key, a stage, a status, a short summary, counts and timestamps. Prompts, diffs, source, shell commands, logs and issue bodies never leave the machine, and the service drops any field it does not recognise rather than storing it. What a report carries is the full list.
What exactly does a report contain?
The issue key and link, the stage and status, who did the work, the repository and branch, where the branch stands as counts, how many pull request checks are passing or failing, a summary of up to 180 characters, and timestamps. What a report carries has all of it.
Can TeamFlow read my issue descriptions and comments?
No. Descriptions, comments, attachments and custom fields are dropped where the webhook arrives, and an import does not ask for them at all. What is kept is the key, the title, the status, the assignee, the labels and the structure around the issue. See connect a tracker.
Does TeamFlow write anything back to my tracker?
Only if an owner turns it on, per connection, and only two things: a comment when a ticket is verified or ready for production, and a move to a status you choose from those two stages. It never reopens or closes an issue. See what a report carries.
Setting up
Which editors and agent tools are supported?
Claude Code, Cursor, VS Code with GitHub Copilot, Windsurf, Cline, OpenAI Codex CLI, Gemini CLI and JetBrains AI Assistant report through their own hooks. Zed and Aider report through git hooks, and Claude Desktop through its rules file. Other tools has the one line for each.
Do I need a tracker to use TeamFlow?
No, but without one the board starts empty and stays that way until something reports. A tracker is what puts an issue on the board before anybody opens an editor. Connecting one is three steps.
Do I have to report from my editor for a ticket to appear?
No. Your tracker’s webhook puts each issue on the board as it is created and keeps its title, assignee, status and labels current. The plugin then moves that ticket through delivery as the work happens. See connect a tracker.
Is there an API key to copy?
No. You sign in once and the plugin uses a one-hour access token it refreshes in the background; only a revocable refresh token is stored. A long-lived organisation key exists as a fallback for environments that can neither open a browser nor mint a CI token. See get started.
Why does sign-in not ask me for a code?
Because it does not need one. The ordinary sign-in opens the browser you are already signed in to and finishes by itself. A code is printed in the terminal only on the device path, login --device, which is for a terminal on a different machine from your browser. See get started.
Projects
What is a project?
One or more repositories, with the Linear projects and Jira projects linked to them. It is how the board is divided up, and a project’s sources decide what its trackers import. See projects.
Why is my work showing as outside any project?
Because the repository you are working in belongs to no project yet. Nothing is lost: the reports land as usual and show under Outside any project, with an option to add the repository to one. See work outside a project.
Can one repository be in two projects?
No. A repository belongs to at most one project per organisation, and adding it to a second is refused with the name of the project that already owns it. Remove it there first. See projects.
Does choosing a project in the header change what gets reported?
No. The project in the header is a view. It never changes what a plugin reports or where a report is written, so you cannot file work in the wrong project by having the wrong one selected. See projects.
What happens to a repository I remove from a project?
Nothing is deleted. Its cards stay in the project’s history, and new reports land outside any project until the repository is added to one again. See projects.
Do git worktrees confuse it?
No. A worktree belongs to the same project as the repository it was made from. See projects.
The board
Where do failed tickets go?
Back to the gate that failed, with a loop drawn to it. Rework is never a column of its own, which is what lets the board say which gate is sending work back. See the delivery flow.
Can I move a card by hand?
No. Every position on the board was reported by the work itself, so a card you dragged would be the one thing on the board that was not true. Change the ticket in your tracker, or do the work. See the delivery flow.
My board is empty after connecting a tracker. Why?
A webhook only reports what happens from now on, so the issues that already existed come from the import. It runs in the background and issues appear as they arrive; press Backfill now rather than waiting. See connect a tracker.
Your account
How do I invite someone?
Send them the invite link from the members page. Joining is invite-only, and each member subscribes individually with their subscription credited to the organisation that invited them. See your team.
How do I remove a machine that is reporting?
Run /teamflow:logout on the machine, which revokes its credential at the service. A machine signed in with the device path can also be revoked from the members page, which is what to use when you no longer have a shell on it. See your team.
Can one person belong to more than one organisation?
Yes. Each machine reports to one organisation at a time, and /teamflow:org switches it. Reports published after the switch are credited to the new organisation and nothing already published moves. See your team.
What happens to my demo account at launch?
Your demo credits are removed and everything else is kept: the organisation, its members, its projects, its tracker connections and everything on the board. To carry on reporting you subscribe. See demo mode.
Do you give refunds?
No. All fees are non-refundable, including for a part-used period, unused reports, a downgrade or a cancellation part-way through a period. The exceptions are a charge we made in error and any refund right the law gives you. See section 5 of the terms of service.
How do I delete my data, or ask a question about it?
Ask your organisation’s owner first if you are a member, because they decide what the organisation reports. You can also come to us directly: the privacy policy has the contact address and what we will do within a month of being asked.