# How to teach Google Antigravity your knowledge

Teach Google Antigravity [your knowledge](https://www.knowman.io/guides/personal-knowledge-base) by adding persistent rules, placing reference files in supported workspace or global locations, or connecting an [MCP server](https://www.knowman.io/guides/mcp-server-knowledge-base) for live context. KnowMan MCP offers tools for searching [saved reading](https://www.knowman.io/guides/ai-article-saver), asking questions with citations, and saving URLs when connected through a compatible MCP client.

## Choose the right way to add knowledge

Use rules for persistent instructions, coding standards, and architectural constraints. Antigravity discovers these rules from the filesystem and injects them into the agent's context, unlike chat prompts that apply to one conversation. [Antigravity Rules documentation](https://antigravity.google/docs/rules)

## Add persistent rules

Place `AGENTS.md`, `GEMINI.md`, or Markdown files in `.agents/rules/` within the workspace or a parent folder up to the repository root. Antigravity combines all discovered rules rather than replacing one set with another. Rules can also live in global configuration. Antigravity Rules documentation

## Control when rules load

Use `model_decision` rules when Antigravity should read the full rule only when a task matches its description. Use `glob` rules when a rule should activate for matching files. Manual rules load when mentioned with `@`, but Antigravity CLI does not support rule mentions. Antigravity Rules documentation

## Include reference files

A rule can include another file with `@[label](path)`. Antigravity resolves relative paths from the rule file, expands `~/` paths, and can include file contents. A rule can also reference a file with `@filename` without inlining its contents. Antigravity Rules documentation

## Watch rule limits

Antigravity does not load rules from subfolders below the workspace folder. A single rule file is limited to 24 KB and is truncated after included paths expand. Active global and `always_on` rules share a 20,000-token budget. Global modular rules in `~/.gemini/config/rules/` require YAML frontmatter. Antigravity Rules documentation

## Add an MCP server

In Antigravity App, open Customizations, select Installed, and find the MCP Servers section. Antigravity connects to local tools, databases, file parsers, and remote APIs through MCP. [Antigravity MCP documentation](https://antigravity.google/docs/mcp/)

## Use KnowMan through MCP

KnowMan MCP offers tools for searching [saved items](https://www.knowman.io/guides/how-to-save-articles), asking questions with citations, reading an item, saving URLs, listing recent items, and reviewing saved claims, decisions, and playbooks. Its hosted server uses OAuth or an API key, while the local [stdio server](https://www.knowman.io/guides/what-is-an-mcp-server) starts with `npx -y @knowman/mcp` and requires Node 22 or newer. [KnowMan MCP](https://github.com/Essatt/knowman-mcp)

## Where KnowMan fits

KnowMan is a separate home for articles, links, answers, and memories, so it fits when your knowledge is larger than a rule file or changes over time. MCP gives compatible clients structured access to that library, while rules remain useful for short, durable guidance. See [MCP server knowledge bases](https://www.knowman.io/guides/mcp-server-knowledge-base) and [AI knowledge bases](https://www.knowman.io/guides/ai-knowledge-base).

## Questions

### How do I teach Antigravity persistent instructions?

Add `AGENTS.md`, `GEMINI.md`, or Markdown files under `.agents/rules/` in the workspace or a parent folder up to the repository root. Antigravity discovers and combines those rules across conversations. Antigravity Rules documentation

### Can Antigravity read my reference files?

Yes. A rule can include file contents with `@[label](path)`, or point to a file with `@filename` without inlining it. Single rule files are limited to 24 KB after includes expand. Antigravity Rules documentation

### Can Antigravity search my KnowMan library?

Antigravity supports MCP servers, which can provide structured context from external APIs. KnowMan MCP can search saved reading, answer questions with citations, read individual items, and save URLs when used through a compatible MCP client. Antigravity MCP documentation and KnowMan MCP

### Can I run KnowMan MCP locally instead?

The KnowMan package can run as a local stdio server with `npx -y @knowman/mcp` and requires Node 22 or newer. KnowMan MCP

## Related guides

- [Connect your knowledge base through KnowMan's MCP server](https://www.knowman.io/guides/mcp-server-knowledge-base)

- [What Is a Knowledge Base for AI Agents?](https://www.knowman.io/guides/knowledge-base-for-ai-agents)

- [How Do You Connect AI to Your Notes?](https://www.knowman.io/guides/connect-any-ai-to-your-notes)

- [How to Give Your AI Context from What You Read](https://www.knowman.io/guides/give-your-ai-context)

## More in this topic

- [How to teach GitHub Copilot your knowledge](https://www.knowman.io/guides/teach-github-copilot-your-knowledge)
- [How to teach GitHub Copilot CLI your knowledge](https://www.knowman.io/guides/teach-github-copilot-cli-your-knowledge)
- [How to teach Microsoft Copilot Studio your knowledge](https://www.knowman.io/guides/teach-copilot-studio-your-knowledge)

## More for Google Antigravity

- [KnowMan MCP server for Google Antigravity](https://www.knowman.io/integrations/antigravity)
- [How to give Google Antigravity better memory](https://www.knowman.io/guides/antigravity-memory)
- [Google Antigravity and your knowledge base](https://www.knowman.io/guides/antigravity-knowledge-base)

## Give Antigravity a wider knowledge base

Try KnowMan Pro for 14 days with no credit card. [Create your account](https://app.knowman.io/signup)

[Start free](https://app.knowman.io/signup)

Every new account starts with 14 days of Pro. No credit card.

Source: https://www.knowman.io/guides/teach-antigravity-your-knowledge
