We are excited to introduce TfCode, ToothFairyAI's official terminal-based AI coding assistant. TfCode brings the power of autonomous AI agents directly to your development workflow, allowing you to edit files, run shell commands, and build features without leaving your terminal.
TfCode is designed for developers who live in the terminal. It combines the conversational flexibility of a large language model with direct access to your local filesystem, version control, and toolchain. Unlike cloud-only coding assistants, TfCode operates within your workspace and can execute real commands to verify its work.
Key Features
- Terminal-based AI assistant — no IDE plugins required
- File editing and refactoring with natural language commands
- Shell command execution and automation
- Seamless integration with your ToothFairyAI workspace
- Git-aware diffs and commit suggestions
- Test running and error interpretation
How Developers Use TfCode
A typical TfCode workflow starts with a plain-language request: "Add pagination to the users endpoint" or "Refactor this component to use React Server Components." TfCode reads the relevant files, proposes a plan, and asks for confirmation before making changes. You can review every diff, accept or reject individual edits, and roll back if needed.
Because TfCode can run shell commands, it does not just write code and hope it compiles. It can install dependencies, run linters, execute tests, and read error output to fix issues iteratively. This closes the loop between suggestion and verified, working code.
Getting Started
Install TfCode globally via npm and start using it immediately. The tool connects to your ToothFairyAI workspace, giving your AI coding agent access to your agents, knowledge hubs, and project context.
After installation, authenticate with your workspace, navigate to a project directory, and start a session. TfCode respects your .gitignore, follows your existing code style, and can be configured to use your preferred shell, package manager, and test runner. Whether you are refactoring a large codebase, writing tests, or exploring a new repository, TfCode accelerates your development process.
Security and Control
TfCode executes commands only after you approve them, and dangerous operations require explicit confirmation. You can run in read-only mode for exploration, restrict which directories the agent can access, and review every change before it reaches your repository. Your source code stays in your environment unless you choose to share it.
