---

Overview

ASI1 Code is an AI-powered coding assistant built for VS Code and Cursor using the ASI1 API.

It gives you a fast, clean sidebar chat so you can:

• Generate code
• Fix errors
• Explain functions
• Create project files
• Understand selected code
• Stream AI responses in real time
• Optionally use tool calling (workspace files) and web search (ASI1 API)
• Scaffold Fetch.ai uAgent projects (uAgents + Agent Chat Protocol) with one command

Instead of switching between tabs, websites, and separate tools, you can stay in the IDE.

---

Why this exists

Building with ASI1 and Agentverse-style workflows should not mean juggling browser tabs and copy-pasted snippets. This extension adds a one-command scaffold aligned with create-agentverse-agent plus chat, tools, and web search in one place.

---

Who is this for?

• Developers who want ASI1 inside the editor.
• Fetch.ai / uAgents builders who want the same folder layout as the official Python CLI.
• Teams that want chat → code → optional Agentverse-ready Python project in one flow.

---

Features (at a glance)

Area	What you get
Chat	Sidebar panel, streaming, Markdown, syntax-highlighted code
Selection	Send the current selection or file context to the model
Workspace	Tools to read files and glob-search paths (when enabled)
Web	web_search via ASI1 (when enabled)
Files	Fenced code + “Save as” hints; optional auto-apply
Agents	ASI: Create Agentverse uAgent Project — main.py, agent.py, Docker, Makefile, .env, etc.
Image	Run… in chat — chat or image endpoint (/v1/image/generate); optional imageBaseUrl, imageModel, imageSize

AI chat inside VS Code

Ask anything from the sidebar chat panel.

Create a React login page
Fix this TypeScript error
Explain this API response
Generate a Tailwind navbar

Streaming responses

Replies stream in as the model generates them (when streaming is enabled and tools are not resolving a multi-step tool loop).

Code highlighting

Markdown and syntax-highlighted code blocks for easier reading.

Ask about selected code

Highlight code and run ASI: Ask About Selection to explain, debug, or improve it.

File generation

Generated files can be written into your workspace (manual Create files or optional auto apply).

Auto apply files

Optional: automatically create files detected from the assistant reply (requires an open folder).

Chat UI & optional branding

The sidebar uses a minimal black theme with an ASI1 Code label, session id, and turn count. Optional asiAssistant.banner* and link settings remain in configuration (compatibility / future use).

Tools & web search (ASI1)

When enabled in settings, requests can include workspace tools and/or web_search per ASI:One / OpenAI-compatible behavior.

Agentverse uAgent scaffold

Command palette: ASI: Create Agentverse uAgent Project — creates a Python project with uAgents and the Agent Chat Protocol (see Agentverse uAgent scaffold).

---

Preview

---

Installation

From VS Code Marketplace

Install from the Marketplace:

https://marketplace.visualstudio.com/items?itemName=gautammanak2.asi1-code

Or open: ASI1 Code — Visual Studio Marketplace

From a .vsix file

npm install
npm run compile
npm run package

Then install:

code --install-extension ./asi1-code-0.1.3.vsix

Or:

• Open Extensions in VS Code
• Click the … menu
• Choose Install from VSIX…
• Select the generated .vsix file

---

Getting started

1. Set your API key

You can configure your ASI1 API key in several ways:

Command Palette

ASI: Set API Key

VS Code settings

"asiAssistant.apiKey": "your_api_key"

Environment variable

export ASI_ONE_API_KEY=your_api_key

Local dev (optional)

A file named .api-key next to the extension folder (development only).

---

2. Open the chat panel

• Use the Activity Bar → ASI1 Code → Chat, or
• Command Palette: ASI: Open Assistant Chat

Shortcut:

Ctrl + Shift + ;
Cmd + Shift + ;   (Mac)

---

Commands

Command	Description
ASI: Open Assistant Chat	Open / focus the chat panel
ASI: Ask About Selection	Ask about selected code (or file)
ASI: Set API Key	Save your API key securely
ASI: Install Extension from .vsix	Install extension from a .vsix file
ASI: Create Agentverse uAgent Project	Scaffold a uAgent project (uAgents + chat protocol)

---

Extension settings

All settings use the asiAssistant.* prefix.

Setting	Description
asiAssistant.apiKey	ASI1 API key
asiAssistant.baseUrl	Chat completions endpoint URL
asiAssistant.model	Model id (e.g. asi1)
asiAssistant.imageBaseUrl	Optional image API base URL (empty = derive from chat URL)
asiAssistant.imageModel	Image model id (empty = fallback to chat model)
asiAssistant.imageSize	Default image size (e.g. 1024x1024)
asiAssistant.systemPrompt	System message for every request
asiAssistant.streamResponse	Stream SSE (off while built-in tools resolve a turn)
asiAssistant.webSearch	Enable ASI1 web_search
asiAssistant.enableTools	Workspace read + glob search via tool calling
asiAssistant.agenticSession	Send x-session-id for agentic flows
asiAssistant.sessionId	Optional fixed session id
asiAssistant.maxToolRounds	Max tool-call rounds per message
asiAssistant.autoApplyFiles	Auto-write detected files after replies
asiAssistant.bannerTitle	Optional banner title (setting retained)
asiAssistant.bannerSubtitle	Optional banner subtitle (setting retained)
asiAssistant.bannerLogoUrl	Optional HTTPS logo URL (setting retained)
asiAssistant.linkWebsite	Website URL
asiAssistant.linkDocs	Documentation URL
asiAssistant.linkX	X (Twitter) URL
asiAssistant.linkCommunity	Community URL
asiAssistant.linkResources	Resources URL
asiAssistant.linkSupport	Support URL
asiAssistant.linkContact	Contact URL

---

Example use cases

Frontend development

• Create React components
• Generate Tailwind UI
• Debug CSS issues
• Build forms and pages

Backend development

• Generate Express routes
• Create APIs
• Build database schemas
• Write authentication logic

Debugging

• Fix TypeScript errors
• Explain stack traces
• Understand console errors
• Improve code quality

Learning

• Explain code line by line
• Learn frameworks faster
• Understand new libraries
• Get examples instantly

---

Agentverse uAgent scaffold

This extension can generate a project aligned with create-agentverse-agent: uAgents, Agent Chat Protocol (uagents_core.contrib.protocols.chat), chat() in agent.py, entry in main.py.

Run: Command Palette → ASI: Create Agentverse uAgent Project → choose a display name and parent folder.

Generated layout (folder name is a slug of your display name):

<your-agent-slug>/
├── main.py              # uAgent, protocols, message manager, Agentverse registration
├── agent.py             # async chat(session_id, user_id, message, logger, send_progress)
├── test.py              # Streamlit test UI
├── Makefile
├── pyproject.toml
├── requirements.txt
├── docker-compose.yml
├── Dockerfile
├── .env
└── README.md

For the interactive Python CLI (wizard, --default, --advanced), see the upstream project: create-agentverse-agent on PyPI.

---

Project structure (this repository)

asi1-vs-code/
├── src/
│   ├── extension.ts           # activation, commands
│   ├── chatViewProvider.ts    # webview chat UI
│   ├── asiClient.ts           # ASI1 API, tools, web_search
│   ├── agentverseScaffold.ts  # Agentverse template render + write
│   └── workspaceFiles.ts      # extract/write files from replies
├── media/                     # chat.css, chatPanel.js, markdown + highlight
├── resources/
│   ├── icon.png, logo.png, readme-banner.png
│   └── agentverse-templates/  # templates for uAgent scaffold
├── package.json
├── README.md
├── README.vsix.md             # Marketplace readme (VSIX packaging)
├── CHANGELOG.md
├── CONTRIBUTING.md
├── SECURITY.md
└── LICENSE

---

Documentation links

Resource	URL
ASI1 API	api.asi1.ai
Fetch.ai	fetch.ai
ASI:One docs	docs.fetch.ai (tool calling, web search, OpenAI compatibility)

---

Development

Clone the repository:

git clone https://github.com/gautammanak1/asi1-vs-code.git
cd asi1-vs-code

Install dependencies:

npm install

Compile:

npm run compile

Run the extension locally:

Press F5 inside VS Code (Extension Development Host)

Optional watch mode:

npm run watch

Package Extension:

npm run package

This README.vsix.md file is what ships as the Marketplace long description when you run npm run package (vsce package --readme-path README.vsix.md) — v0.1.3 includes the icon + banner above. The same content is kept in README.md on GitHub.

---

Roadmap

• Richer workspace context (symbols, diagnostics)
• Workspace-aware AI suggestions
• Multi-file generation and review flow
• Improved file previews
• Optional chat history persistence
• More model options where the API supports them
• UI polish and animations

---

Contributing

Contributions are welcome.

1. Fork the repository
2. Create a new branch
3. Make your changes
4. Commit your work
5. Open a pull request

Please read CONTRIBUTING.md for setup, checks, and PR expectations.
See CHANGELOG.md for release notes.

---

Security

Found a security issue? Please read SECURITY.md instead of opening a public issue.

---

License

This project is licensed under the MIT License.
See LICENSE for full text.

---