百科.dev
全部条目在线工具AI 编程趋势榜开源项目技术资讯提交条目
登录
< 返回工具列表
F

full-self-coding

> 编程语言
开源

没有提示,没有说明,没有计划,你现在正同时编写 100~1000 个 AI 代理,解决你代码库中的所有可能的问题。

368 stars0 点赞0 次浏览
访问官网GitHub

工具介绍

没有提示,没有说明,没有计划,你现在正同时编写 100~1000 个 AI 代理,解决你代码库中的所有可能的问题。

Full Self Coding (FSC)

No prompts, no instructions, no plans, you have 100~1000 AI agent coding in parallel now, solving all possible problems and issues in your codebase.

Overview

Full Self Coding (FSC) is a sophisticated framework designed to automate software engineering tasks by integrating multiple AI agents (Claude Code, Gemini CLI) within Docker containers. It provides intelligent codebase analysis, task decomposition, automated code modification, and comprehensive reporting capabilities.

Key Features

  • ** Multi-Agent Support**: Integration with Claude Code, Gemini CLI, and extensible agent architecture
  • ** Containerized Execution**: Secure, isolated Docker-based task execution
  • ** Intelligent Analysis**: Automated codebase analysis and task identification
  • ⚙️ Flexible Configuration: Hierarchical configuration system with environment variable support
  • ** Comprehensive Reporting**: Detailed execution reports with git diff tracking
  • ** Parallel Processing**: Multi-container parallel task execution with resource management
  • ️ Robust Error Handling: Comprehensive error recovery and graceful degradation

️ Architecture

Core Components

…

Supported Agent Types

Agent Type Description Container Image Key Features
CLAUDE_CODE Anthropic Claude Code integration node:latest Advanced code analysis, natural language processing
GEMINI_CLI Google Gemini CLI integration node:latest Google's AI model integration, fast response
CODEX OpenAI Codex integration (planned) - OpenAI GPT-based code completion

Getting Started

Prerequisites

  • Bun (v1.0.0 or higher)
  • Docker (latest version)
  • Git (for repository operations)

Quick Start

  1. Install bun.js on your machine

    bash
    curl -fsSL https://bun.sh/install | bash
  2. Clone and setup the project

    bash
    git clone https://github.com/NO-CHATBOT-REVOLUTION/full-self-coding.git
    cd full-self-coding
    bun install
  3. Run on a repository

    bash
    # Run CLI from source
    bun run start
    
    # Or run on a specific repository
    full-self-coding

Installation as npm Package

The project is structured as a monorepo with two main packages:

  • @full-self-coding/core: Core library for code analysis and task execution
  • @full-self-coding/cli: Command-line interface

Core Package

bash
npm install @full-self-coding/core

CLI Package

bash
npm install -g @full-self-coding/cli
# Then run:
full-self-coding-cli

⚙️ Configuration

Configuration Hierarchy

Full Self Coding uses a hierarchical configuration system with the following precedence (highest to lowest):

  1. Environment Variables (FSC_*)
  2. Project-level Configuration (.fsc/config.json)
  3. User Configuration (~/.config/full-self-coding/config.json)
  4. Default Values

Configuration Options

Field Type Default Description
agentType SWEAgentType CLAUDE_CODE AI agent to use (claude-code, gemini-cli)
maxDockerContainers number 10 Maximum Docker containers allowed
maxParallelDockerContainers number 3 Maximum parallel container execution
dockerTimeoutSeconds number 600 Docker command timeout in seconds
dockerMemoryMB number 1024 Docker container memory limit in MB
dockerCpuCores number 2 Docker container CPU core limit
dockerImageRef string "node:latest" Docker image reference for containers
maxTasks number 100 Maximum tasks to generate during analysis
minTasks number 1 Minimum tasks to generate during analysis
workStyle WorkStyle DEFAULT Work style (default, bold_genius, careful, etc.)
customizedWorkStyle string - Custom work style description
codingStyleLevel number 5 Coding style level (0-10)
customizedCodingStyle string - Custom coding style description
anthropicAPIKey string - Anthropic API key
anthropicAPIBaseUrl string - Custom Anthropic API base URL
anthropicAPIKeyExportNeeded boolean true Whether to export Anthropic API key
googleGeminiApiKey string - Google Gemini API key
googleGeminiAPIKeyExportNeeded boolean true Whether to export Gemini API key
openAICodexApiKey string - OpenAI Codex API key
openAICodexAPIKeyExportNeeded boolean true Whether to export OpenAI API key

Configuration Files

Global Configuration (~/.config/full-self-coding/config.json)

json
{
  "agentType": "claude-code",
  "anthropicAPIKey": "sk-ant-api03-...",
  "maxDockerContainers": 8,
  "maxParallelDockerContainers": 4,
  "dockerTimeoutSeconds": 600,
  "dockerMemoryMB": 2048,
  "workStyle": "bold_genius",
  "customizedWorkStyle": "Focus on rapid prototyping and innovation"
}

Project Configuration (.fsc/config.json)

json
{
  "agentType": "gemini-cli",
  "googleGeminiApiKey": "AIzaSy...",
  "maxTasks": 50,
  "minTasks": 5,
  "codingStyleLevel": 8,
  "customizedCodingStyle": "Follow enterprise coding standards with comprehensive documentation"
}

Environment Variables

bash
# API Keys
export FSC_ANTHROPIC_API_KEY="sk-ant-api03-..."
export FSC_GOOGLE_GEMINI_API_KEY="AIzaSy..."
export FSC_OPENAI_CODEX_API_KEY="sk-..."

# Docker Settings
export FSC_MAX_DOCKER_CONTAINERS=15
export FSC_DOCKER_TIMEOUT_SECONDS=900
export FSC_DOCKER_MEMORY_MB=4096

# Agent Configuration
export FSC_AGENT_TYPE="claude-code"
export FSC_WORK_STYLE="bold_genius"
export FSC_CODING_STYLE_LEVEL=9

Usage Guide

Command Line Interface

The CLI provides various options for configuration and execution:

bash
full-self-coding-cli run [options]

Options

Option Short Type Description
--agent-type -a string AI agent type (claude-code, gemini-cli)
--config -c string Path to configuration file
--help -h - Show help information
--version -V - Show version information

Examples

Basic Repository Analysis

bash
# Analyze current repository with default settings
full-self-coding-cli run

# Analyze with custom config
full-self-coding-cli run --config ./my-config.json

Core Library Usage

typescript
import { analyzeCodebase, TaskSolverManager, createConfig } from '@full-self-coding/core';

// Create configuration
const config = createConfig({
  agentType: 'claude-code',
  anthropicAPIKey: 'your-api-key'
});

// Analyze repository
const tasks = await analyzeCodebase(config, 'https://github.com/user/repo.git');

// Execute tasks
const taskSolver = new TaskSolverManager(config, 'https://github.com/user/repo.git');
for (const task of tasks) {
  taskSolver.addTask(task);
}
await taskSolver.start();

API Reference

Core Classes

ConfigReader

Manages configuration loading, validation, and merging.

typescript
import { ConfigReader, readConfigWithEnv } from '@full-self-coding/core';

// Read configuration with environment variable support
const config = readConfigWithEnv();

// Create custom configuration
import { createConfig } from '@full-self-coding/core';
const customConfig = createConfig({
  agentType: 'claude-code',
  anthropicAPIKey: 'your-api-key'
});

Methods

  • readConfigWithEnv(): Config - Read config with environment variables
  • createConfig(userConfig: Partial): Config - Create configuration from user config
  • getGitRemoteUrls(useSSH?: boolean): Promise - Get git remote URLs

DockerInstance

Manages Docker container lifecycle and operations.

typescript
import { DockerInstance, DockerRunStatus } from '@full-self-coding/core';

const docker = new DockerInstance();

// Start container
const containerName = await docker.startContainer('node:latest', 'my-task');

// Run commands
const result = await docker.runCommands(['npm', 'install']);

// Copy files
await docker.copyFileToContainer('local.txt', '/app/remote.txt');
await docker.copyFilesToContainer('./src', '/app/src');

// Copy files from container
const content = await docker.copyFileFromContainer('/app/output.txt');

// Shutdown
await docker.shutdownContainer();

Methods

  • startContainer(imageRef: string, taskName?: string): Promise - Start new container
  • runCommands(commands: string[], timeout?: number): Promise - Execute commands
  • copyFileToContainer(localPath: string, containerPath: string): Promise - Copy single file
  • copyFilesToContainer(localPath: string, containerPath: string): Promise - Copy recursively
  • copyFileFromContainer(containerPath: string): Promise - Copy file from container
  • shutdownContainer(): Promise - Stop and remove container

TaskSolver

Executes individual tasks within Docker containers.

typescript
import { TaskSolver, SWEAgentType } from '@full-self-coding/core';

const taskSolver = new TaskSolver(
  config,
  task,
  SWEAgentType.CLAUDE_CODE,
  'https://github.com/user/repo.git'
);

// Solve the task
await taskSolver.solve();

// Get results
const result = taskSolver.getResult();

Methods

  • solve(shutdown?: boolean): Promise - Execute the task
  • getResult(): TaskResult - Get task execution result

Analyzer

Analyzes codebases and generates task lists.

typescript
import { analyzeCodebase } from '@full-self-coding/core';

// Analyze a repository
const tasks = await analyzeCodebase(
  config,
  'https://github.com/user/repo.git'
);

Configuration Types

…

Testing

Running Tests

bash
# Run all tests from project root
bun run test

# Or run from core package
cd packages/core
bun test

# Run with timeout
bun test --timeout 30000

Test Structure

packages/core/test/
├── dockerInstance.test.ts           # Docker functionality tests
├── configReaderSupplementary.test.ts # Configuration system tests
├── taskSolverClaudeCode.test.ts     # Claude Code task solver tests
├── taskSolverGemini.test.ts         # Gemini task solver tests
└── integration/                     # Integration tests
    ├── full-workflow.test.ts        # End-to-end workflow tests
    └── multi-agent.test.ts          # Multi-agent integration tests

Writing Tests

…

Docker Integration

Container Management

FSC creates isolated Docker containers for each task execution, ensuring:

  • Security: Complete isolation from host system
  • Consistency: Reproducible execution environments
  • Parallelism: Multiple tasks can run simultaneously
  • Resource Management: Controlled CPU and memory usage

Supported Operations

  • File copying (both directions)
  • Command execution with timeout protection
  • Real-time output streaming
  • Resource monitoring
  • Graceful shutdown

Custom Docker Images

You can use custom Docker images:

json
{
  "dockerImageRef": "custom/node:18-alpine",
  "dockerMemoryMB": 1536,
  "dockerCpuCores": 3
}

Troubleshooting

Common Issues

Docker Connectivity

bash
# Check Docker daemon
docker --version
docker info

# Test container creation
docker run --rm hello-world

Permission Issues

bash
# Add user to docker group (Linux)
sudo usermod -aG docker $USER
newgrp docker

API Key Problems

bash
# Verify API key format
echo $FSC_ANTHROPIC_API_KEY | head -c 20

# Test API connectivity
curl -H "x-api-key: $FSC_ANTHROPIC_API_KEY" \
     https://api.anthropic.com/v1/messages \
     -d '{"model":"claude-3-sonnet-20240229","max_tokens":10,"messages":[{"role":"user","content":"Hi"}]}'

Debug Mode

Enable debug logging:

bash
export DEBUG=fsc:*
node dist/main.js --debug https://github.com/user/re

Issues· 0 开放

查看全部 Issues在 GitHub 打开

暂无开放 Issues,或尚未同步最近议题。

> 标签

TypeScript

暂无评论,来聊聊你的看法吧

> 工具信息

发布日期2026年8月1日
最后更新2026年9月17日
分类编程语言
定价开源

> 相关工具

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言