# eduardogiraudi/fyc architecture

> Architecture diagram of the GitHub repository eduardogiraudi/fyc, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/eduardogiraudi/fyc
- Repository: https://github.com/eduardogiraudi/fyc

## Overview

fuckyourcli is an interactive terminal AI coding assistant. The main workflow is a user chatting in the terminal, the assistant calling configured model providers and workspace tools, and the user reviewing approved changes and results; sessions preserve conversation context. Separate capabilities include web research, language-server queries, MCP integrations, plugins, and an AG-UI HTTP backend. The README documents these product relationships, but most implementation files were not sampled, so links to those subsystems are dashed rather than asserted as verified calls.

Main entry points: [`tools/tools.go`](https://github.com/eduardogiraudi/fyc/blob/master/tools/tools.go) (Tool registry), [`session.go`](https://github.com/eduardogiraudi/fyc/blob/master/session.go) (Chat session), [`main.go`](https://github.com/eduardogiraudi/fyc/blob/master/main.go) (CLI entry), [`ui/input.go`](https://github.com/eduardogiraudi/fyc/blob/master/ui/input.go) (Terminal UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["Chat experience"]
  node_cli["CLI entry<br/>[main.go]"]
  node_terminal["Terminal UI<br/>[input.go]"]
end

subgraph group_assistant["Assistant runtime"]
  node_session["Chat session<br/>[session.go]"]
  node_providers["Model providers<br/>[provider_types.go]"]
  node_tools["Tool registry<br/>[tools.go]"]
  node_reasoning["Reasoning profiles<br/>[profiles.go]"]
end

subgraph group_integrations["Tools and integrations"]
  node_sandbox["Command sandbox<br/>[sandbox.go]"]
  node_workspace["Workspace tools"]
  node_web["Web research<br/>[crawl.go]"]
  node_lsp["Language servers<br/>[manager.go]"]
  node_mcp["MCP client<br/>[manager.go]"]
  node_subagents["Sub-agents<br/>[subagent_tool.go]"]
  node_computer["Computer use<br/>[computer_tools.go]"]
  node_hooks["Tool hooks<br/>[hooks.go]"]
  node_plugins["Plugin installer<br/>[install.go]"]
  node_agui["AG-UI server<br/>[server.go]"]
  node_agui_runner["AG-UI runner<br/>[agui_interactor.go]"]
end

subgraph group_state["Configuration and state"]
  node_config["Configuration<br/>[types.go]"]
  node_sessions[("Session storage<br/>[sessionstore.go]")]
  node_models["Model catalog<br/>[catalog.go]"]
end

node_user(("User"))

node_user -->|"starts chat"| node_cli
node_cli -.->|"opens interface"| node_terminal
node_terminal -.->|"sends prompts"| node_session
node_session -.->|"requests responses"| node_providers
node_session -.->|"invokes tools"| node_tools
node_tools -->|"offers file operations"| node_workspace
node_tools -->|"offers safe execution"| node_sandbox
node_tools -->|"offers web research"| node_web
node_tools -->|"offers LSP queries"| node_lsp
node_tools -->|"offers MCP tools"| node_mcp
node_tools -->|"offers sub-agents"| node_subagents
node_tools -->|"offers computer use"| node_computer
node_tools -->|"supports hooks"| node_hooks
node_user -->|"installs plugins"| node_plugins
node_cli -->|"serves HTTP backend"| node_agui
node_agui -.->|"runs requests"| node_agui_runner
node_cli -.->|"loads settings"| node_config
node_session -->|"persists sessions"| node_sessions
node_session -.->|"uses reasoning profiles"| node_reasoning
node_config -->|"configures models"| node_models

click node_cli "https://github.com/eduardogiraudi/fyc/blob/master/main.go"
click node_terminal "https://github.com/eduardogiraudi/fyc/blob/master/ui/input.go"
click node_session "https://github.com/eduardogiraudi/fyc/blob/master/session.go"
click node_providers "https://github.com/eduardogiraudi/fyc/blob/master/providers/provider_types.go"
click node_tools "https://github.com/eduardogiraudi/fyc/blob/master/tools/tools.go"
click node_sandbox "https://github.com/eduardogiraudi/fyc/blob/master/tools/sandbox.go"
click node_workspace "https://github.com/eduardogiraudi/fyc/blob/master/tools/filesystem_tools.go"
click node_web "https://github.com/eduardogiraudi/fyc/blob/master/crawl/crawl.go"
click node_lsp "https://github.com/eduardogiraudi/fyc/blob/master/lsp/manager.go"
click node_mcp "https://github.com/eduardogiraudi/fyc/blob/master/mcp/manager.go"
click node_subagents "https://github.com/eduardogiraudi/fyc/blob/master/tools/subagent_tool.go"
click node_computer "https://github.com/eduardogiraudi/fyc/blob/master/tools/computer_tools.go"
click node_hooks "https://github.com/eduardogiraudi/fyc/blob/master/tools/hooks.go"
click node_plugins "https://github.com/eduardogiraudi/fyc/blob/master/plugins/install.go"
click node_agui "https://github.com/eduardogiraudi/fyc/blob/master/agui/server.go"
click node_agui_runner "https://github.com/eduardogiraudi/fyc/blob/master/agui_interactor.go"
click node_config "https://github.com/eduardogiraudi/fyc/blob/master/config/types.go"
click node_sessions "https://github.com/eduardogiraudi/fyc/blob/master/sessionstore.go"
click node_reasoning "https://github.com/eduardogiraudi/fyc/blob/master/reasoning/profiles.go"
click node_models "https://github.com/eduardogiraudi/fyc/blob/master/models/catalog.go"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_terminal,node_user toneBlue
class node_session,node_providers,node_tools,node_reasoning toneAmber
class node_sandbox,node_workspace,node_web,node_lsp,node_mcp,node_subagents,node_computer,node_hooks,node_plugins,node_agui,node_agui_runner toneMint
class node_config,node_sessions,node_models toneRose
```

## Components

### Chat experience

- [CLI entry](https://github.com/eduardogiraudi/fyc/blob/master/main.go): `main.go`
- [Terminal UI](https://github.com/eduardogiraudi/fyc/blob/master/ui/input.go): `ui/input.go`

### Assistant runtime

- [Chat session](https://github.com/eduardogiraudi/fyc/blob/master/session.go): `session.go`
- [Model providers](https://github.com/eduardogiraudi/fyc/blob/master/providers/provider_types.go): `providers/provider_types.go`
- [Tool registry](https://github.com/eduardogiraudi/fyc/blob/master/tools/tools.go): `tools/tools.go`
- [Reasoning profiles](https://github.com/eduardogiraudi/fyc/blob/master/reasoning/profiles.go): `reasoning/profiles.go`

### Tools and integrations

- [Command sandbox](https://github.com/eduardogiraudi/fyc/blob/master/tools/sandbox.go): `tools/sandbox.go`
- [Workspace tools](https://github.com/eduardogiraudi/fyc/blob/master/tools/filesystem_tools.go): `tools/filesystem_tools.go`
- [Web research](https://github.com/eduardogiraudi/fyc/blob/master/crawl/crawl.go): `crawl/crawl.go`
- [Language servers](https://github.com/eduardogiraudi/fyc/blob/master/lsp/manager.go): `lsp/manager.go`
- [MCP client](https://github.com/eduardogiraudi/fyc/blob/master/mcp/manager.go): `mcp/manager.go`
- [Sub-agents](https://github.com/eduardogiraudi/fyc/blob/master/tools/subagent_tool.go): `tools/subagent_tool.go`
- [Computer use](https://github.com/eduardogiraudi/fyc/blob/master/tools/computer_tools.go): `tools/computer_tools.go`
- [Tool hooks](https://github.com/eduardogiraudi/fyc/blob/master/tools/hooks.go): `tools/hooks.go`
- [Plugin installer](https://github.com/eduardogiraudi/fyc/blob/master/plugins/install.go): `plugins/install.go`
- [AG-UI server](https://github.com/eduardogiraudi/fyc/blob/master/agui/server.go): `agui/server.go`
- [AG-UI runner](https://github.com/eduardogiraudi/fyc/blob/master/agui_interactor.go): `agui_interactor.go`

### Configuration and state

- [Configuration](https://github.com/eduardogiraudi/fyc/blob/master/config/types.go): `config/types.go`
- [Session storage](https://github.com/eduardogiraudi/fyc/blob/master/sessionstore.go): `sessionstore.go`
- [Model catalog](https://github.com/eduardogiraudi/fyc/blob/master/models/catalog.go): `models/catalog.go`

### Other components

- **User**

## Connections

- User → CLI entry: starts chat (evidence: `README.md`)
- CLI entry → Terminal UI: opens interface
- Terminal UI → Chat session: sends prompts
- Chat session → Model providers: requests responses
- Chat session → Tool registry: invokes tools
- Tool registry → Workspace tools: offers file operations (evidence: `README.md`)
- Tool registry → Command sandbox: offers safe execution (evidence: `README.md`)
- Tool registry → Web research: offers web research (evidence: `README.md`)
- Tool registry → Language servers: offers LSP queries (evidence: `README.md`)
- Tool registry → MCP client: offers MCP tools (evidence: `README.md`)
- Tool registry → Sub-agents: offers sub-agents (evidence: `README.md`)
- Tool registry → Computer use: offers computer use (evidence: `README.md`)
- Tool registry → Tool hooks: supports hooks (evidence: `README.md`)
- User → Plugin installer: installs plugins (evidence: `README.md`)
- CLI entry → AG-UI server: serves HTTP backend (evidence: `README.md`)
- AG-UI server → AG-UI runner: runs requests
- CLI entry → Configuration: loads settings
- Chat session → Session storage: persists sessions (evidence: `README.md`)
- Chat session → Reasoning profiles: uses reasoning profiles
- Configuration → Model catalog: configures models (evidence: `README.md`)
