autocomplete

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

★ 25,219 Open GitHub ↗

기존 터미널 및 셸을 위한 IDE 스타일의 자동 완성

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![Badge: macOS](https://img.shields.io/badge/os-%20macOS-light)](https://raw.githubusercontent.com/withfig/autocomplete/master/)
[![Badge: Documentation](https://img.shields.io/badge/documentation-black)](https://fig.io/docs/)
[![Badge: contributors](https://img.shields.io/github/contributors/withfig/autocomplete)](https://raw.githubusercontent.com/withfig/autocomplete/master/)

**[Amazon Q Developer CLI](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-getting-started-installing.html)**는
`git`, `npm`, `docker`, `aws`와 같이 널리 쓰이는 수백 개의 CLI에 대해 IDE 스타일의 자동 완성을 추가합니다. 타이핑을 시작하면 Amazon Q가 문맥에 적절한 하위 명령어(subcommands), 옵션 및 인자를 표시합니다.

> 이전에 [Fig](https://fig.io)로 알려졌던 Amazon Q Developer CLI는 오픈 소스입니다. 더 자세한 내용은 [aws/amazon-q-developer-cli]( https://github.com/aws/amazon-q-developer-cli)에서 확인하세요.

## ⚡️ Installation

- **macOS**:
  - **DMG**: AWS에서 다운로드:
    [aws.amazon.com](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-getting-started-installing.html)
  - **Homebrew**: `brew install amazon-q`
- **Linux/Windows**:
  - 다음의 토론 내용을 확인하세요:
    [Linux](https://github.com/aws/q-command-line-discussions/discussions/14) 또는
    [Windows](https://github.com/aws/q-command-line-discussions/discussions/15)
- **Remote machines**
  - [SSH에서 자동 완성 사용하기](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-autocomplete-ssh.html)

> 참고: 다운로드가 완료되면 앱을 실행하여 커맨드 라인용 Amazon Q를 설정하세요!

![Demo of Amazon Q's CLI Completions in a terminal](https://docs.aws.amazon.com/images/amazonq/latest/qdeveloper-ug/images/command-line-completions.gif)

## 👋 "completion specs"란 무엇인가요?

completion spec은 CLI 도구의 `subcommands`, `options` 및 `args`를 지정하는 *선언적(declarative)* 스키마입니다. Amazon Q는 이 스키마를 사용하여 제안 사항을 생성합니다.

## 😎 3분 만에 첫 spec 기여하기

아래 단계를 따르거나 시작 가이드를 참고하세요:
[fig.io/docs](https://fig.io/docs)

**사전 요구 사항:**

- 커맨드 라인용 Amazon Q 다운로드
- Node 및 Pnpm

**단계**

1. 이 저장소에서 사용하는 패키지 매니저인 `pnpm`이 [설치](https://pnpm.io/installation)되어 있는지 확인하세요.

2. [여기](https://GitHub.com/withfig/autocomplete/fork/)를 클릭하여 이 저장소를 포크(fork)하세요.

3. 포크한 저장소를 클론하고 예시 spec을 생성합니다.

```bash
   # `YOUR_GITHUB_USERNAME`을 본인의 GitHub 사용자 이름으로 바꾸세요
   git clone https://github.com/YOUR_GITHUB_USERNAME/autocomplete.git autocomplete
   cd autocomplete

# withfig/autocomplete를 remote로 추가
   git remote add upstream https://github.com/withfig/autocomplete.git

# 패키지 설치
   pnpm install

# 예시 spec 생성 (이름을 "abc"라고 지정)
   pnpm create-spec abc

# "dev mode" 켜기
   pnpm dev
   ```

4. 이제 터미널로 가서 `abc[space]`를 입력하세요. 생성한 예시 spec이 나타날 것입니다. 😊

#### 기타 참고 사항

- `src/` 폴더에서 TypeScript로 spec을 수정하세요.
- 저장 시 spec은 `build/` 폴더로 컴파일됩니다.
- **dev mode**에서는 `build` 폴더에서 spec을 읽으며, 키를 입력할 때마다 제너레이터가 실행됩니다.

## 📦 기타 사용 가능한 package.json 명령어

```bash
# src/ 폴더의 모든 spec 타입 체크
pnpm test

# src/ 폴더의 TypeScript spec을 build/ 폴더로 컴파일
pnpm build

# 린트 및 문제 수정
pnpm lint:fix
```

## 🔥 Contributions

다음과 같은 기여를 환영합니다:

- 새로운 completion specs
- 기존 completion specs의 오류 (예: 누락된 하위 명령어, 옵션 또는 인자)
- 인자 제안을 위한 [Generators](https://fig.io/docs/getting-started/generating-argument-suggestions)
- 더 나은 설명, 아이콘 등
- [Themes](https://github.com/withfig/themes)!

기여가 어려우신 분들은 언제든지 [issue](https://github.com/withfig/autocomplete/issues/new/choose)를 남겨주세요.

## 🙋‍♀️ FAQ

#### Amazon Q는 어떤 터미널에서 작동하나요?

커맨드 라인용 Amazon Q는 macOS 기본 터미널 앱, [iTerm], [Tabby], [Hyper], [Kitty], [WezTerm], [Alacritty]에서 작동합니다. 또한 [VSCode], [JetBrains IDEs], [Android Studio], [Nova]의 통합 터미널에서도 작동합니다.

[iterm]: https://iterm2.com
[tabby]: https://tabby.sh
[hyper]: https://hyper.is
[kitty]: https://sw.kovidgoyal.net/kitty
[wezterm]: https://wezfurlong.org/wezterm/
[alacritty]: https://alacritty.org/
[vscode]: https://code.visualstudio.com/
[jetbrains ides]: https://www.jetbrains.com/
[android studio]: https://developer.android.com/studio
[nova]: https://nova.app/

다른 터미널의 지원을 원하시나요? [issue tracker](https://github.com/aws/q-command-line-discussions)를 확인하고 의견을 남겨주세요!

#### 커맨드 라인용 Amazon Q는 어떻게 작동하나요?

커맨드 라인용 Amazon Q는 Mac의 Accessibility API를 사용하여 윈도우 위치를 지정하며, 셸과 통합되어 사용자가 입력한 내용을 읽습니다.

#### 커맨드 라인용 Amazon Q가 Windows나 Linux에서도 작동하나요?

아직은 지원하지 않으며, 현재는 macOS에서만 사용할 수 있습니다. [Windows](https://github.com/aws/q-command-line-discussions/discussions/15) 및 [Linux](https://github.com/aws/q-command-line-discussions/discussions/14) 지원이 진행 중입니다!

#### Amazon Q를 어떻게 다운로드하나요?

`brew install amazon-q`를 실행하거나, [aws.amazon.com](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-getting-started-installing.html)에서 앱을 다운로드하세요. 그 후 Amazon Q 앱을 실행하세요!

#### PR은 어떻게 제출하나요?

[기여 방법(How to Contribute)](https://fig.io/docs/getting-started/contributing) 가이드를 확인하세요. Amazon Q의 400명 이상의 기여자 중 많은 분들이 Amazon Q를 통해 첫 오픈 소스 기여를 시작했습니다!

#### 커맨드 라인용 Amazon Q가 작동하지 않습니다!

`q doctor`를 실행하여 설치 문제를 자동으로 디버깅하세요. 문제가 계속되면 GitHub discussions 커뮤니티에 이슈를 남겨주세요:
[aws/q-command-line-discussions](https://github.com/aws/q-command-line-discussions/discussions)

## ✨ Contributors

autocomplete

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README